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Preface 


TTRX [1] is a typesetting system that is very suitable for producing scien- 
tific and mathematical documents of high typographical quality. It is also 
suitable for producing all sorts of other documents, from simple letters to 
complete books. IATEX uses TEX |2] as its formatting engine. 

This short introduction describes ATFX 2¢ and should be sufficient for 
most applications of ATRX. Refer to [1, 3] for a complete description of the 
I4TRX system. 


This introduction is split into 6 chapters: 


Chapter 1 tells you about the basic structure of ATRX 2¢- documents. You 
will also learn a bit about the history of ATX. After reading this 
chapter, you should have a rough understanding how IATRX works. 


Chapter 2 goes into the details of typesetting your documents. It explains 
most of the essential ATX commands and environments. After read- 
ing this chapter, you will be able to write your first documents, with 
itemized lists, tables, graphics and floating bodies. 


Chapter 3 explains how to typeset formulae with ATRX. Many examples 
demonstrate how to use one of IATRX’s main strengths. At the end 
of the chapter are tables listing all mathematical symbols available in 


LTEX. 


Chapter 4 explains indexes, bibliography generation and some finer points 
about creating PDFs. 


Chapter 5 shows how to use I4TpX for creating graphics. Instead of draw- 
ing a picture with some graphics program, saving it to a file and then 
including it into ATRX, you describe the picture and have 44TRX draw 
it for you. 


Chapter 6 contains some potentially dangerous information about how to 
alter the standard document layout produced by ATRXx. It will tell you 
how to change things such that the beautiful output of ATRX turns 
ugly or stunning, depending on your abilities. 
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It is important to read the chapters in order—the book is not that big, after 
all. Be sure to carefully read the examples, because a lot of the information 
is in the examples placed throughout the book. 


TATRX is available for most computers, from the PC and Mac to large UNIX 
and VMS systems. On many university computer clusters you will find that 
a IATRX installation is available, ready to use. Information on how to access 
the local AT RX installation should be provided in the Local Guide [5]. If you 
have problems getting started, ask the person who gave you this booklet. 
The scope of this document is not to tell you how to install and set up a 
I4TeX system, but to teach you how to write your documents so that they 
can be processed by XT RX. 


If you need to get hold of any JATRX related material, have a look at one of 
the Comprehensive TEX Archive Network (CTAN) sites. The homepage is 
at http: //www.ctan.org. 

You will find other references to CTAN throughout the book, especially 
pointers to software and documents you might want to download. Instead 
of writing down complete URLs, I just wrote CTAN: followed by whatever 
location within the CTAN tree you should go to. 

If you want to run ATRX on your own computer, take a look at what is 
available from CTAN://systems. 


If you have ideas for something to be added, removed or altered in this 
document, please let me know. I am especially interested in feedback from 
IATRX novices about which bits of this intro are easy to understand and 
which could be explained better. 


Tobias Oetiker <tobi@oetiker.ch> 


OETIKER+PARTNER AG 
Aarweg 15 

4600 Olten 

Switzerland 


The current version of this document is available on 
CTAN://info/lshort 
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Chapter 1 


Things You Need to Know 


The first part of this chapter presents a short overview of the philosophy and 
history of ATEX2<. The second part focuses on the basic structures of a ATEX 
document. After reading this chapter, you should have a rough knowledge of 
how IATEX works, which you will need to understand the rest of this book. 


1.1 A Bit of History 
1a ‘Tex 


TeX is a computer program created by Donald E. Knuth [2]. It is aimed 
at typesetting text and mathematical formulae. Knuth started writing the 
TRX typesetting engine in 1977 to explore the potential of the digital printing 
equipment that was beginning to infiltrate the publishing industry at that 
time, especially in the hope that he could reverse the trend of deteriorating 
typographical quality that he saw affecting his own books and articles. TRX 
as we use it today was released in 1982, with some slight enhancements 
added in 1989 to better support 8-bit characters and multiple languages. 
TX is renowned for being extremely stable, for running on many different 
kinds of computers, and for being virtually bug free. The version number of 
TRX is converging to 7 and is now at 3.14159265. 

TrX is pronounced “Tech,” with a “ch” as in the German word “Ach”! or 
in the Scottish “Loch.” The “ch” originates from the Greek alphabet where 
X is the letter “ch” or “chi”. TEX is also the first syllable of the Greek word 
technique. In an ASCII environment, TRX becomes TeX. 





‘In German there are actually two pronunciations for “ch” and one might assume that the 
soft “ch” sound from “Pech” would be a more appropriate. Asked about this, Knuth wrote in 
the German Wikipedia: I do not get angry when people pronounce TRX in their favorite way 

.. and in Germany many use a soft ch because the X follows the vowel e, not the harder ch 

that follows the vowel a. In Russia, ‘tex’ is a very common word, pronounced ‘tyekh’. But I 
believe the most proper pronunciation is heard in Greece, where you have the harsher ch of 
ach and Loch. 
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1.1.2 BTpx 


I4TeX enables authors to typeset and print their work at the highest typo- 
graphical quality, using a predefined, professional layout. ATRX was origi- 
nally written by Leslie Lamport [1]. It uses the TX formatter as its type- 
setting engine. These days ATX is maintained by the IATRX Project. 

I4TRX is pronounced “Lay-tech” or “Lah-tech.” If you refer to ATRX in 
an ASCII environment, you type LaTeX. ATRX 2¢ is pronounced “Lay-tech 
two e” and typed LaTeX2e. 


1.2 Basics 


1.2.1 Author, Book Designer, and Typesetter 


To publish something, authors give their typed manuscript to a publishing 
company. One of their book designers then decides the layout of the docu- 
ment (column width, fonts, space before and after headings, ...). The book 
designer writes his instructions into the manuscript and then gives it to a 
typesetter, who typesets the book according to these instructions. 

A human book designer tries to find out what the author had in mind 
while writing the manuscript. He decides on chapter headings, citations, 
examples, formulae, etc. based on his professional knowledge and from the 
contents of the manuscript. 

In a ATRX environment, MTpX takes the role of the book designer and 
uses TRX as its typesetter. But LATRX is “only” a program and therefore 
needs more guidance. The author has to provide additional information to 
describe the logical structure of his work. This information is written into 
the text as “IATRX commands.” 

This is quite different from the WYSIWYG? approach that most modern 
word processors, such as MS Word or LibreOffice, take. With these appli- 
cations, authors specify the document layout interactively while typing text 
into the computer. They can see on the screen how the final work will look 
when it is printed. 

When using FTX it is not normally possible to see the final output 
while typing the text, but the final output can be previewed on the screen 
after processing the file with TeX. Then corrections can be made before 
actually sending the document to the printer. 


1.2.2 Layout Design 


Typographical design is a craft. Unskilled authors often commit serious 
formatting errors by assuming that book design is mostly a question of 
aesthetics—‘“If a document looks good artistically, it is well designed.” But 





’What you see is what you get. 


1.2 Basics 





as a document has to be read and not hung up in a picture gallery, the 
readability and understandability is much more important than the beautiful 
look of it. Examples: 


e The font size and the numbering of headings have to be chosen to make 
the structure of chapters and sections clear to the reader. 


e The line length has to be short enough not to strain the eyes of the 
reader, while long enough to fill the page beautifully. 


With WYSIWYG systems, authors often generate aesthetically pleasing 
documents with very little or inconsistent structure. ATX prevents such 
formatting errors by forcing the author to declare the logical structure of his 
document. AT@X then chooses the most suitable layout. 


1.2.3. Advantages and Disadvantages 


When people from the WYSIWYG world meet people who use ATRX, they 
often discuss “the advantages of IATfX over a normal word processor” or the 
opposite. The best thing to do when such a discussion starts is to keep a low 
profile, since such discussions often get out of hand. But sometimes there is 
no escaping ... 


So here is some ammunition. The main advantages of ATRX over normal 
word processors are the following: 


e Professionally crafted layouts are available, which make a document 
really look as if “printed.” 


e The typesetting of mathematical formulae is supported in a convenient 
way. 


e Users only need to learn a few easy-to-understand commands that 
specify the logical structure of a document. They almost never need 
to tinker with the actual layout of the document. 


e Even complex structures such as footnotes, references, table of con- 
tents, and bibliographies can be generated easily. 


e Free add-on packages exist for many typographical tasks not directly 
supported by basic ATpxX. For example, packages are available to 
include POSTSCRIPT graphics or to typeset bibliographies conforming 
to exact standards. Many of these add-on packages are described in 
The ATEX Companion [3]. 


e IATRX encourages authors to write well-structured texts, because this 
is how ATRX works—by specifying structure. 


Things You Need to Know 





e TRX, the formatting engine of ATRX 2¢, is highly portable and free. 
Therefore the system runs on almost any hardware platform available. 


I4TRX also has some disadvantages, and I guess it’s a bit difficult for me to 
find any sensible ones, though I am sure other people can tell you hundreds 


3-) 


e I4TRX does not work well for people who have sold their souls ... 


Although some parameters can be adjusted within a predefined docu- 
ment layout, the design of a whole new layout is difficult and takes a 
lot of time.® 


It is very hard to write unstructured and disorganized documents. 


Your hamster might, despite some encouraging first steps, never be 
able to fully grasp the concept of Logical Markup. 


1.3 FATRX Input Files 


The input for ATRX is a plain text file. On Unix/Linux text files are pretty 
common. On windows, one would use Notepad to create a text file. It 
contains the text of the document, as well as the commands that tell 4TRx 
how to typeset the text. If you are working with a ATRX IDE, it will contain 
a program for creating IATRX input files in text format. 


1.3.1 Spaces 


“Whitespace” characters, such as blank or tab, are treated uniformly as 
“space” by ATRX. Several consecutive whitespace characters are treated as 
one “space”. Whitespace at the start of a line is generally ignored, and a 
single line break is treated as “whitespace”. 

An empty line between two lines of text defines the end of a paragraph. 
Several empty lines are treated the same as one empty line. The text below 
is an example. On the left hand side is the text from the input file, and on 
the right hand side is the formatted output. 


It does not matter whether you 
enter one or several spaces 
after a word. 


An empty line starts a new 
paragraph. 








It does not matter whether you enter one 
or several spaces after a word. 


An empty line starts a new paragraph. 








’Rumour says that this is one of the key elements that will be addressed in the upcoming 


LETRX3 system. 
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1.3.2 Special Characters 


The following symbols are reserved characters that either have a special 
meaning under IATRX or are not available in all the fonts. If you enter them 
directly in your text, they will normally not print, but rather coerce ATRX 
to do things you did not intend. 


He DS Re oe A ON 


As you will see, these characters can be used in your documents all the 
same by using a prefix backslash: 





\# \$ \% \7tt \& \L \t \F \4{F 4 7 
\textbackslash #$%~ & _ {}7~ \ 








The other symbols and many more can be printed with special commands 
in mathematical formulae or as accents. The backslash character \ can not 
be entered by adding another backslash in front of it (\\); this sequence is 
used for line breaking. Use the \textbackslash command instead. 


1.3.3 LTpxX Commands 


IATRX commands are case sensitive, and take one of the following two for- 
mats: 


e They start with a backslash \ and then have a name consisting of 
letters only. Command names are terminated by a space, a number or 
any other ‘non-letter.’ 


e They consist of a backslash and exactly one non-letter. 


e Many commands exist in a ‘starred variant’ where a star is appended 
to the command name. 


I4TRX ignores whitespace after commands. If you want to get a space 
after a command, you have to put either an empty parameter {} and a blank 
or a special spacing command after the command name. The empty param- 
eter {} stops TeX from eating up all the white space after the command 
name. 





New \TeX users may miss whitespaces ~ x 
y P New TrXusers may miss whitespaces af- 


ter a command. Experienced TEX users 
are TfXperts, and know how to use white- 
spaces. 


after a command. 4% renders wrong 
Experienced \TeX{} users are 
\TeX perts, and know how to use 
whitespaces. % renders correct 








Some commands require a parameter, which has to be given between 
curly braces { } after the command name. Some commands take optional 
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parameters, which are inserted after the command name in square brack- 
ets [ ]. 


\command [optional parameter] {parameter} 


The next examples use some ATX commands. Don’t worry about them; 
they will be explained later. 





You can \textsl{lean} on me! 


Please, start a new line 
right here! \newline 
Thank you! 


1.3.4 Comments 





You can lean on me! 














Please, start a new line right here! 
Thank you! 








When I4TRX encounters a % character while processing an input file, it ig- 
nores the rest of the present line, the line break, and all whitespace at the 
beginning of the next line. 

This can be used to write notes into the input file, which will not show 
up in the printed version. 


This is an % stupid 
% Better: instructive <---- 
example: Supercal% 
ifragilist% 
icexpialidocious 








This is an example: Supercalifragilisticex- 
pialidocious 





The % character can also be used to split long input lines where no 
whitespace or line breaks are allowed. 
For longer comments you could use the comment environment provided 


by the verbatim package. 


Add the line \usepackage{verbatim} to the 


preamble of your document as explained below to use this command. 


This is another 
\begin{comment} 

rather stupid, 

but helpful 

\end{comment} 

example for embedding 
comments in your document. 








This is another example for embedding 
comments in your document. 





Note that this won’t work inside complex environments, like math for 


example. 


1.4 Input File Structure 





1.4 Input File Structure 


When I4TRX 2¢ processes an input file, it expects it to follow a certain struc- 
ture. Thus every input file must start with the command 


\documentclass{...} 


This specifies what sort of document you intend to write. After that, add 
commands to influence the style of the whole document, or load packages 
that add new features to the ATX system. To load such a package you use 
the command 


\usepackage{...} 


When all the setup work is done,‘ you start the body of the text with 
the command 


\begin{document} 


Now you enter the text mixed with some useful ATRX commands. At 
the end of the document you add the 


\end{document} 


command, which tells ATRX to call it a day. Anything that follows this 
command will be ignored by ATRX. 

Figure 1.1 shows the contents of a minimal ATX 2¢ file. A slightly more 
complicated input file is given in Figure 1.2. 


1.5 A Typical Command Line Session 


I bet you must be dying to try out the neat small IATRX input file shown 
on page 7. Here is some help: TRX itself comes without a GUI or fancy 
buttons to press. It is just a program that crunches away at your input 
file. Some FATRX installations feature a graphical front-end where there is 
a LATRX button to start compiling your input file. On other systems there 





“The area between \documentclass and \begin{document} is called the preamble. 





\documentclass{article} 
\begin{document} 

Small is beautiful. 
\end{document} 





Figure 1.1: A Minimal TRx File. 
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might be some typing involved, so here is how to coax ATX into compiling 
your input file on a text based system. Please note: this description assumes 
that a working IATRX installation already sits on your computer.° 


1. Edit /Create your ATRX input file. This file must be plain ASCII text. 


On Unix all the editors will create just that. On Windows you might 
want to make sure that you save the file in ASCII or Plain Text format. 
When picking a name for your file, make sure it bears the extension 
. tex. 


. Open a shell or cmd window, cd to the directory where your input file 
is located and run I4TRX on your input file. If successful you will end 
up with a .pdf file. It may be necessary to run IAT#X several times to 
get the table of contents and all internal references right. When your 
input file has a bug AATRX will tell you about it and stop processing 
your input file. Type ctr1-D to get back to the command line. 











xelatex foo.tex 








This is the case with most well groomed Unix Systems, and ... Real Men use Unix, so 


wigs) 





\documentclass [a4paper, 11pt] {article} 
% define the title 

\author{H. ~Part1} 

\title{Minimalism} 

\begin{document} 

% generates the title 

\maketitle 

% insert the table of contents 
\tableofcontents 

\section{Some Interesting Words} 
Well, and here begins my lovely article. 
\section{Good Bye World} 

\ldots{} and here it ends. 
\end{document} 





Figure 1.2: Example of a Realistic Journal Article. Note that all the com- 
mands you see in this example will be explained later in the introduction. 


1.6 The Layout of the Document 





1.6 The Layout of the Document 


1.6.1 Document Classes 


The first information I4TfX needs to know when processing an input file is 
the type of document the author wants to create. This is specified with the 
\documentclass command. 





\documentclass [options] {class} 











Here class specifies the type of document to be created. Table 1.1 lists the 
document classes explained in this introduction. The ATRX 2¢ distribution 
provides additional classes for other documents, including letters and slides. 
The options parameter customizes the behavior of the document class. The 
options have to be separated by commas. The most common options for the 
standard document classes are listed in Table 1.2. 


Example: An input file for a ATRX document could start with the line 
\documentclass[11pt,twoside, a4paper] {article} 


which instructs ATX to typeset the document as an article with a base 
font size of eleven points, and to produce a layout suitable for double sided 
printing on A4 paper. 


Table 1.1: Document Classes. 





article for articles in scientific journals, presentations, short reports, pro- 
gram documentation, invitations, ... 


proc a class for proceedings based on the article class. 


minimal is as small as it can get. It only sets a page size and a base font. 
It is mainly used for debugging purposes. 


report for longer reports containing several chapters, small books, PhD 
theses, ... 


book for real books 


slides for slides. The class uses big sans serif letters. You might want to 
consider using the Beamer class instead. 
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Table 1.2: Document Class Options. 





10pt, lipt, 12pt Sets the size of the main font in the document. If no 
option is specified, 10pt is assumed. 


a4paper, letterpaper,... Defines the paper size. The default size is 
letterpaper. Besides that, ajpaper, b5paper, executivepaper, 
and legalpaper can be specified. 


fleqn Typesets displayed formulae left-aligned instead of centred. 


leqno Places the numbering of formulae on the left hand side instead of 
the right. 


titlepage, notitlepage Specifies whether a new page should be 
started after the document title or not. The article class does not 
start a new page by default, while report and book do. 


onecolumn, twocolum Instructs 4TRX to typeset the document in one 
column or two columns. 


twoside, oneside Specifies whether double or single sided output 
should be generated. The classes article and report are single 
sided and the book class is double sided by default. Note that this 
option concerns the style of the document only. The option twoside 
does not tell the printer you use that it should actually make a 
two-sided printout. 


landscape Changes the layout of the document to print in landscape 
mode. 


openright, openany Makes chapters begin either only on right hand 
pages or on the next page available. This does not work with the 
article class, as it does not know about chapters. The report class 
by default starts chapters on the next page available and the book 
class starts them on right hand pages. 





1.7 Files You Might Encounter 
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1.6.2 Packages 


While writing your document, you will probably find that there are some 
areas where basic FATRX cannot solve your problem. If you want to include 
graphics, coloured text or source code from a file into your document, you 
need to enhance the capabilities of ATRX. Such enhancements are called 
packages. Packages are activated with the 











\usepackage Loptions] {package} 





command, where package is the name of the package and options is a list 
of keywords that trigger special features in the package. The \usepackage 
command goes into the preamble of the document. See section 1.4 for details. 

Some packages come with the ATRX 2¢ base distribution (See Table 1.3). 
Others are provided separately. You may find more information on the 
packages installed at your site in your Local Guide [5]. The prime source for 
information about ATEX packages is The ATEX Companion [3]. It contains 
descriptions on hundreds of packages, along with information of how to write 
your own extensions to ATRX 2¢. 

Modern TrX distributions come with a large number of packages prein- 
stalled. If you are working on a Unix system, use the command texdoc for 
accessing package documentation. 


1.6.3 Page Styles 


I4TRX supports three predefined header /footer combinations—so-called page 
styles. The style parameter of the 





\pagestyle{style} 











command defines which one to use. Table 1.4 lists the predefined page styles. 
It is possible to change the page style of the current page with the com- 
mand 











\thispagestyle{style} 





A description how to create your own headers and footers can be found 
in The ATEX Companion [3] and in section 4.3 on page 76. 


1.7 Files You Might Encounter 


When you work with TeX you will soon find yourself in a maze of files 
with various extensions and probably no clue. The following list explains 
the various file types you might encounter when working with TRX. Please 
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Table 1.3: Some of the Packages Distributed with ATpx. 





doc Allows the documentation of ATX programs. 
Described in doc.dtx’ and in The ATRX Companion [3]. 


exscale Provides scaled versions of the math extension font. 
Described in ltexscale. dtx. 


fontenc Specifies which font encoding JATRX should use. 
Described in ltoutenc.dtx. 


ifthen Provides commands of the form 
‘if...then do...otherwise do....’ 
Described in ifthen.dtx and The ATX Companion [3]. 


latexsym To access the ETRX symbol font, you should use the latexsym 
package. Described in latexsym.dtx and in The ATX Companion [3]. 


makeidx Provides commands for producing indexes. Described in section 4.2 
and in The ATgZX Companion [3]. 


syntonly Processes a document without typesetting it. 


inputenc Allows the specification of an input encoding such as ASCII, 
ISO Latin-1, ISO Latin-2, 437/850 IBM code pages, Apple Mac- 
intosh, Next, ANSI-Windows or user-defined one. Described in 
inputenc.dtx. 








“This file should be installed on your system, and you should be able to get a dvi file by 
typing latex doc.dtx in any directory where you have write permission. The same is true 
for all the other files mentioned in this table. 


Table 1.4: The Predefined Page Styles of ATRX. 





plain prints the page numbers on the bottom of the page, in the middle of 
the footer. This is the default page style. 


headings prints the current chapter heading and the page number in the 
header on each page, while the footer remains empty. (This is the style 
used in this document) 


empty sets both the header and the footer to be empty. 





1.7 Files You Might Encounter 
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note that this table does not claim to be a complete list of extensions, but 
if you find one missing that you think is important, please drop me a line. 


. tex 


sty 


.dtx 


-ins 


.cls 


TeX or TEX input file. Can be compiled with latex. 


TeX Macro package. Load this into your AXTRX document using the 
\usepackage command. 


Documented TeX. This is the main distribution format for ATpX style 
files. If you process a .dtx file you get documented macro code of the 
lTRX package contained in the .dtx file. 


The installer for the files contained in the matching .dtx file. If you 
download a IATRX package from the net, you will normally get a .dtx 
and a .ins file. Run ATX on the .ins file to unpack the .dtx file. 


Class files define what your document looks like. They are selected 
with the \documentclass command. 


.fd Font description file telling AT@X about new fonts. 


The following files are generated when you run JATRX on your input file: 


.dvi 


.log 


. toc 


. lof 
- Lot 


- aux 


.idx 


-ind 


-ilg 


Device Independent File. This is the main result of a classical ATRX 
compile run. Look at its content with a DVI previewer program or 
send it to a printer with dvips or a similar application. If you are 
using pdff4TfX then you should not see any of these files. 


Gives a detailed account of what happened during the last compiler 
run. 


Stores all your section headers. It gets read in for the next compiler 
run and is used to produce the table of contents. 


This is like .toc but for the list of figures. 
And again the same for the list of tables. 


Another file that transports information from one compiler run to the 
next. Among other things, the .aux file is used to store information 
associated with cross-references. 


If your document contains an index. ATpX stores all the words that 
go into the index in this file. Process this file with makeindex. Refer 
to section 4.2 on page 74 for more information on indexing. 


The processed .idx file, ready for inclusion into your document on the 
next compile cycle. 


Logfile telling what makeindex did. 
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1.8 Big Projects 


When working on big documents, you might want to split the input file into 
several parts. ATX has two commands that help you to do that. 











\includeffilename} 





Use this command in the document body to insert the contents of another file 
named filename.tex. Note that ATX will start a new page before processing 
the material input from filename.tez. 

The second command can be used in the preamble. It allows you to 
instruct ATRX to only input some of the \included files. 











\includeonlytfilename, filename, ...} 





After this command is executed in the preamble of the document, only 
\include commands for the filenames that are listed in the argument of the 
\includeonly command will be executed. 

The \include command starts typesetting the included text on a new 
page. This is helpful when you use \includeonly, because the page breaks 
will not move, even when some include files are omitted. Sometimes this 
might not be desirable. In this case, use the 











\input{ filename} 





command. It simply includes the file specified. No flashy suits, no strings 
attached. 

To make IATRX quickly check your document use the syntonly package. 
This makes AT@X skim through your document only checking for proper 
syntax and usage of the commands, but doesn’t produce any (pdf) output. 
As I4TRX runs faster in this mode you may save yourself valuable time. 
Usage is very simple: 


\usepackage{syntonly} 
\syntaxonly 


When you want to produce pages, just comment out the second line (by 
adding a percent sign). 


Chapter 2 


Typesetting Text 


After reading the previous chapter, you should know about the basic stuff of 
which a IATEX 2¢ document is made. In this chapter | will fill in the remaining 
structure you will need to know in order to produce real world material. 


2.1 The Structure of Text and Language 


By Hanspeter Schmid <hanspi@schmid-werren.ch> 


The main point of writing a text, is to convey ideas, information, or knowl- 
edge to the reader. The reader will understand the text better if these ideas 
are well-structured, and will see and feel this structure much better if the 
typographical form reflects the logical and semantic structure of the content. 

I4TRX is different from other typesetting systems in that you just have 
to tell it the logical and semantic structure of a text. It then derives the 
typographical form of the text according to the “rules” given in the document 
class file and in various style files. 

The most important text unit in ATPX (and in typography) is the para- 
graph. We call it “text unit” because a paragraph is the typographical form 
that should reflect one coherent thought, or one idea. You will learn in 
the following sections how to force line breaks with e.g. \\, and paragraph 
breaks with e.g. leaving an empty line in the source code. Therefore, if a new 
thought begins, a new paragraph should begin, and if not, only line breaks 
should be used. If in doubt about paragraph breaks, think about your text 
as a conveyor of ideas and thoughts. If you have a paragraph break, but 
the old thought continues, it should be removed. If some totally new line of 
thought occurs in the same paragraph, then it should be broken. 

Most people completely underestimate the importance of well-placed 
paragraph breaks. Many people do not even know what the meaning of 
a paragraph break is, or, especially in IATRX, introduce paragraph breaks 
without knowing it. The latter mistake is especially easy to make if equa- 
tions are used in the text. Look at the following examples, and figure out 
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why sometimes empty lines (paragraph breaks) are used before and after the 
equation, and sometimes not. (If you don’t yet understand all commands 
well enough to understand these examples, please read this and the following 
chapter, and then read this section again.) 


% Example 1 
\ldots when Einstein introduced his formula 
\beginfequation} 

e =m \cdot c72 \; , 
\end{equation} 
which is at the same time the most widely known 
and the least well understood physical formula. 


% Example 2 
\ldots from which follows Kirchhoff's current law: 
\beginfequation} 
\sum_{k=1}-{n} I_k = 0 \; 
\end{equation} 


Kirchhoff's voltage law can be derived \ldots 


% Example 3 
\ldots which has several advantages. 


\beginfequation} 
I_D = I_LF - I_R 
\end{equation} 
is the core of a very different transistor model. \ldots 


The next smaller text unit is a sentence. In English texts, there is a 
larger space after a period that ends a sentence than after one that ends an 
abbreviation. LFATp@X tries to figure out which one you wanted to have. If 
ITREX gets it wrong, you must tell it what you want. This is explained later 
in this chapter. 

The structuring of text even extends to parts of sentences. Most lan- 
guages have very complicated punctuation rules, but in many languages 
(including German and English), you will get almost every comma right if 
you remember what it represents: a short stop in the flow of language. If 
you are not sure about where to put a comma, read the sentence aloud and 
take a short breath at every comma. If this feels awkward at some place, 
delete that comma; if you feel the urge to breathe (or make a short stop) at 
some other place, insert a comma. 


2.2 Line Breaking and Page Breaking 
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Finally, the paragraphs of a text should also be structured logically at a 
higher level, by putting them into chapters, sections, subsections, and so on. 
However, the typographical effect of writing e.g. \section{The Structure 
of Text and Language} is so obvious that it is almost self-evident how 
these high-level structures should be used. 


2.2 Line Breaking and Page Breaking 


2.2.1 Justified Paragraphs 


Books are often typeset with each line having the same length. ATpxX inserts 
the necessary line breaks and spaces between words by optimizing the con- 
tents of a whole paragraph. If necessary, it also hyphenates words that would 
not fit comfortably on a line. How the paragraphs are typeset depends on 
the document class. Normally the first line of a paragraph is indented, and 
there is no additional space between two paragraphs. Refer to section 6.3.2 
for more information. 
In special cases it might be necessary to order IATRX to break a line: 











\\ or \newline 





starts a new line without starting a new paragraph. 








\\* 








additionally prohibits a page break after the forced line break. 











\newpage 





starts a new page. 





\linebreak[n], \nolinebreak[n], \pagebreak[n], \nopagebreak[n] 











suggest places where a break may (or may not) happen. They enable the 
author to influence their actions with the optional argument n, which can be 
set to a number between zero and four. By setting n to a value below 4, you 
leave ATX the option of ignoring your command if the result would look 
very bad. Do not confuse these “break” commands with the “new” commands. 
Even when you give a “break” command, I4TpxX still tries to even out the 
right border of the line and the total length of the page, as described in the 
next section; this can lead to unpleasant gaps in your text. If you really want 
to start a “new line” or a “new page”, then use the corresponding command. 
Guess their names! 
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l4TeX always tries to produce the best line breaks possible. If it cannot 
find a way to break the lines in a manner that meets its high standards, it 
lets one line stick out on the right of the paragraph. JATfX then complains 
(“overfull hbox”) while processing the input file. This happens most often 
when IATRX cannot find a suitable place to hyphenate a word.! Instruct 
IATRX to lower its standards a little by giving the \sloppy command. It 
prevents such over-long lines by increasing the inter-word spacing—even if 
the final output is not optimal. In this case a warning (“underfull hbox”) is 
given to the user. In most such cases the result doesn’t look very good. The 
command \fussy brings IATRX back to its default behaviour. 


2.2.2 Hyphenation 


I4TpX hyphenates words whenever necessary. If the hyphenation algorithm 
does not find the correct hyphenation points, remedy the situation by using 
the following commands to tell TRX about the exception. 

The command 











\hyphenation{word list} 





causes the words listed in the argument to be hyphenated only at the points 
marked by “-”. The argument of the command should only contain words 
built from normal letters, or rather signs that are considered to be normal 
letters by ATfX. The hyphenation hints are stored for the language that 
is active when the hyphenation command occurs. This means that if you 
place a hyphenation command into the preamble of your document it will 
influence the English language hyphenation. If you place the command 
after the \begin{document} and you are using some package for national 
language support like polyglossia, then the hyphenation hints will be active 
in the language activated through polyglossia. 

The example below will allow “hyphenation” to be hyphenated as well as 
“Hyphenation”, and it prevents “FORTRAN”, “Fortran” and “fortran” from 
being hyphenated at all. No special characters or symbols are allowed in the 
argument. 

Example: 


\hyphenation{FORTRAN Hy-phen-a-tion} 


The command \- inserts a discretionary hyphen into a word. This also 
becomes the only point hyphenation is allowed in this word. This command 
is especially useful for words containing special characters (e.g. accented 





‘Although STRX gives you a warning when that happens (Overfull \hbox) and displays 
the offending line, such lines are not always easy to find. If you use the option draft in the 
\documentclass command, these lines will be marked with a thick black line on the right 
margin. 


2.3 Ready-Made Strings 





characters), because IAT&X does not automatically hyphenate words con- 
taining special characters. 





I think this is: su\-per\-cal\-% 
i\-frag\-i\-lis\-tic\-ex\-pi\-% 


al\-i\-do\-cious docious 





I think this is: supercalifragilisticexpiali- 





Several words can be kept together on one line with the command 








\mbox{ text} 








It causes its argument to be kept together under all circumstances. 





My phone number will change soon. 


It will be \mbox{0116 291 2319}. My phone number will change soon. 
will be 0116 291 2319. 


The parameter The parameter filename should contain 


\mbox{\emph{filename}} should the name of the file. 
contain the name of the file. 








\fbox is similar to \mbox, but in addition there will be a visible box 
drawn around the content. 


2.3. Ready-Made Strings 


In some of the examples on the previous pages, you have seen some very 
simple ATEX commands for typesetting special text strings: 





Command Example Description 

\today March 9, 2021 Current date 

\TeX TRxX Your favorite typesetter 
\LaTeX TaTRX The Name of the Game 
\LaTeXe TSTRX 2 The current incarnation 


2.4 Special Characters and Symbols 


2.4.1 Quotation Marks 


You should not use the " for quotation marks as you would on a typewriter. 
In publishing there are special opening and closing quotation marks. In 
IATRX, use two ~ (grave accent) for opening quotation marks and two ' (ver- 
tical quote) for closing quotation marks. For single quotes you use just one 
of each. 





~“Please press the ~x' key.'' “Please press the ‘x’ key.” 











It's $-30\,7{\circ}\mathrm{C}$. 
I will soon start to 
super-conduct. 
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Yes I know the rendering is not ideal, it’s really a back-tick or grave 

accent (*) for opening quotes and vertical quote (') for closing, despite what 
the font chosen might suggest. 
2.4.2 Dashes and Hyphens 
I4TeX knows four kinds of dashes. Access three of them with different num- 
ber of consecutive dashes. The fourth sign is actually not a dash at all—it 
is the mathematical minus sign: 

daughter-in-law, X-rated\\ daughter-in-law, X-rated 

pages 13--67\\ pages 13-67 

yes---or no? \\ yes—or no? 

$0$, $1$ and $-1$ 0, 1 and —-1 

The names for these dashes are: ‘-’ hyphen, ‘—’ en-dash, ‘—’ em-dash 

and ‘—’ minus sign. 
2.4.3 Tilde (~) 
A character often seen in web addresses is the tilde. To generate this in 
TeX use \~{} but the result (~) is not really what you want. Try this 
instead: 

http://www.rich.edu/\~{}bush \\ http://www.rich.edu/~ bush 

http: //www.clever.edu/$\sim$demo http: //www.clever.edu/~demo 








2.4.4 Slash (/) 


In order to typeset a slash between two words, one can simply type e.g. 
read/write, but this makes IAIFX treat the two words as one. Hyphen- 
ation is disabled for these two words, so there may be ‘overfull’ errors. To 
overcome this, use \slash. For example type ‘read\slash write’ which 
allows hyphenation. But normal ‘/’ character may be still used for ratios or 
units, e.g. 5 MB/s. 


2.4.5 Degree Symbol (0c) 
Printing the degree symbol in pure ATPX. 





It’s —30°C. I will soon start to super- 
conduct. 
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The textcomp package makes the degree symbol also available as \textdegree 
or in combination with the C by using the \textcelsius. 





30 \textcelsius{} is 


86 \textdegree{}F. 30 °C is 86 °F. 








2.4.6 The Euro Currency Symbol (€) 


When writing about money these days, you need the Euro symbol. Many 
current fonts contain a Euro symbol. After loading the textcomp package in 
the preamble of your document 











\usepackage{textcomp} 





use the command 





\texteuro 











to access it. 

If your font does not provide its own Euro symbol or if you do not like 
the font’s Euro symbol, you have two more choices: 

First the eurosym package. It provides the official Euro symbol: 








\usepackage [official] feurosym} 








If you prefer a Euro symbol that matches your font, use the option gen 
in place of the official option. 


Table 2.1: A bag full of Euro symbols 





LM-+textcomp \texteuro € € € 


eurosym \euro € € € 
[genjeurosym \euro € € S 





2.4.7 Ellipsis (...) 


On a typewriter, a comma or a period takes the same amount of space as 
any other letter. In book printing, these characters occupy only a little space 
and are set very close to the preceding letter. Therefore, entering ‘ellipsis’ 
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by just typing three dots would produce the wrong result. Instead, there is 
a special command for these dots. It is called 
\ldots (low dots) 
Not like this ... but like this:\\ | Not like this ... but like this: 


New York, Tokyo, Budapest, \ldots 


2.4.8 Ligatures 





New York, Tokyo, Budapest, ... 





Some letter combinations are typeset not just by setting the different letters 
one after the other, but by actually using special symbols. 


ffiflfi... insteadof fhffi... 


These so-called ligatures can be prohibited by inserting an \mbox{} between 
the two letters in question. This might be necessary with words built from 


two words. 


\Large Not shelfful\\ 
but shelf\mbox{}ful 








Not shelfful 
but shelfful 





2.4.9 Accents and Special Characters 


I4TeX supports the use of accents and special characters from many lan- 
guages. Table 2.2 shows all sorts of accents being applied to the letter o. 
Naturally other letters work too. 

To place an accent on top of an i or a j, its dots have to be removed. 
This is accomplished by typing \i and \j. 





H\*otel, na\"\i ve, \'el\~eve,\\ 
sm\o rrebr\o d, !~Se\~norita!,\\ 
Sch\"onbrunner Schlo\ss{} 
Stra\ss e 





Hotel, naive, éléve, 
smérrebred, jSefiorital, 
Sch6nbrunner Schlof& Strafe 





2.5 International Language Support 


By Axel Kielhorn <A.Kielhorn@web.de> 


When you write documents in languages other than English, there are three 
areas where I4TRX has to be configured appropriately: 


2.5 International Language Support 
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1. All automatically generated text strings? have to be adapted to the 
new language. 


2. IXTRX needs to know the hyphenation rules for the current language. 


3. Language specific typographic rules. In French for example, there is a 
mandatory space before each colon character (:). 


Also entering text in your language of choice might be a bit cumbersome 
using all the commands from figure 2.2. To overcome this problem, until 
recently you had to delve deep into the abyss of language specific encodings 
both for input as well as fonts. These days, with modern TX engines 
speaking UTF-8 natively, these problems have relaxed considerably. 

The package polyglossia|18] is a replacement for venerable babel package. 
It takes care of the hyphenation patterns and automatically generated text 
strings in your documents. 

The package fontspec|20| handles font loading for XqMTpX and LuaTpx. 
The default font is Latin Modern Roman. 


2.5.1 Polyglossia Usage 


Depending on the TFX engine you use slightly different commands are nec- 
essary in the preamble of your document to properly enable multilingual 
processing. Figure 2.1 on page 24 shows a sample preamble that takes care 
of all the necessary settings. 

So far there has been no advantage to using a Unicode TRX engine. 
This changes when we leave the Latin script and move to a more interesting 
language like Greek or Russian. With a Unicode based system, you can 





Table of Contents, List of Figures, ... 


Table 2.2: Accents and Special Characters. 





Oo \o 6 \'o 6 \To 6 \To 
0 \=o o \.o 6 \"o e “\ecc 
6 \uo 6 \vo 6 \Ho Qg \co 
o \do o \bo 60 \t oo 

ce \oe C \OE ze  \ae HE \AE 
A \aa A \AA 

® \o © \O t \l L AL 

1 \i J} \ ; we i? 
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simply enter the native characters in your editor and TpX will understand 
them. 

Writing in different languages is easy, just specify the languages in the 
preamble. This example uses the csquotes package which generates the right 
kind of quotes according to the language you are writing in. Note that it 
needs to be loaded before loading the language support. 





\usepackage [autostyle=true] {csquotes} 
\setdefaultlanguage{english} 
\setotherlanguage{german} 











To write a paragraph in German, you can use the German environment: 


English text. 





b 
Sbegtnigerman) English text. Deutscher ,/Text“. More En- 
Deutscher \enquote{Text}. a ss 

glish “text”. 
\end{german} 








More English \enquote{text}. 


If you just need a word in a foreign language you can use the \text language 
command: 





Did you know that 
\textgerman{Gesundheit} is 
actually a German word. 


Did you know that Gesundheit is actually 
a German word. 








This may look unnecessary since the only advantage is a correct hy- 
phenation, but when the second language is a little bit more exotic it will 
be worth the effort. 

Sometimes the font used in the main document does not contain glyphs 
that are required in the second language. Latin Modern for example does 





3For small values of simple. 





\usepackage{iftex} 
\ifXeTeX 

\usepackage{fontspec} 
\else 

\usepackage{luatextra} 
Wi 
\defaultfontfeatures{Ligatures=TeX} 
\usepackage{polyglossia} 





Figure 2.1: All in one preamble that takes care of Lual4TRX and Xql4TRX 
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not contain Cyrillic letters. The solution is to define a font that will be used 
for that language. Whenever a new language is activated, polyglossia will 
first check whether a font has been defined for that language. If you are 
happy with the computer modern font, you may want to try the “Computer 
Modern Unicode” font by adding the following commands to the preamble 
of your document. 


For Lual4TpX it is pretty simple 


\setmainfont{CMU Serif} 
\setsansfont{CMU Sans Serif} 
\setmonofont{CMU Typewriter Text} 


For Xq4TRX you have to be a bit more explicit: 


\setmainfont{cmun}[ 
Extension=.otf ,UprightFont=*rm, ItalicFont=*ti, 
BoldFont=*bx , BoldItalicFont=*bi, 

] 

\setsansfont{cmun}[ 
Extension=.otf,UprightFont=*ss ,ItalicFont=*si, 
BoldFont=*sx,BoldItalicFont=*so, 

] 

\setmonofont{cmun}[ 
Extension=.otf,UprightFont=*btl,ItalicFont=*bto, 
BoldFont=*tb,BoldItalicFont=*tx, 


With the appropriate fonts loaded, you can now write: 





\textrussian{lpapga} is 
a russian newspaper. IIpapga is a russian newspaper. cde 
\textgreek{aAyGeta} is truth is truth or disclosure in philosophy 








or disclosure in philosophy 


The package xgreek[21] offers support for writing either ancient or mod- 
ern (monotonic or polytonic) greek. 


Right to Left (RTL) languages. 


Some languages are written left to right, others are written right to left(RTL). 
polyglossia needs the bidi[22] package* in order to support RTL languages. 
The bidi package should be the last package you load, even after hyperref 
which is usually the last package. (Since polyglossia loads bidi this means 
that polyglossia should be the last package loaded.) 





“bidi does not support LuaTpXx. 
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The package xepersian[23]| offers support for the Persian language. It 
supplies Persian 4TfX-commands that allows you to enter commands like 
\section in Persian, which makes this really attractive to native speakers. 
xepersian is the only package that supports kashida with XqM4Tpx. A package 
for Syriac which uses a similar algorithm is under development. 

The IranNastaliq font provided by the SCICT? is available at their web- 
site http: //www.scict.ir/Portal/Home/Default.aspx. 

The arabxetex|[19|] package supports several languages with an Arabic 
script: 


e arab (Arabic) 
e persian 

e urdu 

e sindhi 

e pashto 

e ottoman (turk) 
e kurdish 

e kashmiri 

e malay (jawi) 

e uighur 


It offers a font mapping that enables XqIATRX to process input using the 
ArabTpxX ASCII transcription. 

Fonts that support several Arabic laguages are offered by the IRMUG° 
at http: //wiki.irmug.org/index.php/X_Series_2. 

There is no package available for Hebrew because none is needed. The 
Hebrew support in polyglossia should be sufficient. But you do need a 
suitable font with real Unicode Hebrew. SBL Hebrew is free for non- 
commercial use and available at http: //www.sbl-site.org/educational/ 
biblicalfonts.aspx. Another font available under the Open Font License 
is Ezra SIL, available at http: //www.sil.org/computing/catalog/show_ 
software.asp?id=76. 

Remember to select the correct script: 





\newf ontfamily\hebrewf ont [Script=Hebrew]{SBL Hebrew} 
\newf ontfamily\hebrewf ont [Script=Hebrew] {Ezra SIL} 














°*Supreme Council of Information and Communication Technology 
*‘Tranian Mac User Group 
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Chinese, Japanese and Korean (CJK) 


The package xeCJK|24] takes care of font selection and punctuation for these 
languages. 


2.6 The Space Between Words 


To get a straight right margin in the output, JATFX inserts varying amounts 
of space between the words. It inserts slightly more space at the end of a 
sentence, as this makes the text more readable. JATfX assumes that sen- 
tences end with periods, question marks or exclamation marks. If a period 
follows an uppercase letter, this is not taken as a sentence ending, since 
periods after uppercase letters normally occur in abbreviations. 

Any exception from these assumptions has to be specified by the author. 
A backslash in front of a space generates a space that will not be enlarged. A 
tilde ‘~’ character generates a space that cannot be enlarged and additionally 
prohibits a line break. The command \@ in front of a period specifies that 
this period terminates a sentence even when it follows an uppercase letter. 





Mr.~Smith was happy to see her\\ Mr. Smith was happy to see her 
cf.~Fig.~5\\ cf. Fig. 5 
I like BASIC\@. What about you? I like BASIC. What about you? 








The additional space after periods can be disabled with the command 











\frenchspacing 





which tells LT@X not to insert more space after a period than after an or- 
dinary character. This is very common in non-English languages, except 
bibliographies. If you use \frenchspacing, the command \@ is not neces- 
sary. 


2.7 Titles, Chapters, and Sections 


To help the reader find his or her way through your work, you should divide 
it into chapters, sections, and subsections. I4TfX supports this with special 
commands that take the section title as their argument. It is up to you to 
use them in the correct order. 
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The following sectioning commands are available for the article class: 





\section{...} 
\subsection{...} 
\subsubsection{...} 
\paragraph{...} 
\subparagraph{...} 











If you want to split your document into parts without influencing the 
section or chapter numbering use 











\part{...} 





When you work with the report or book class, an additional top-level 
sectioning command becomes available 











\chapter{...} 





As the article class does not know about chapters, it is quite easy 
to add articles as chapters to a book. The spacing between sections, the 
numbering and the font size of the titles will be set automatically by MATpXx. 

Two of the sectioning commands are a bit special: 


e The \part command does not influence the numbering sequence of 
chapters. 


e The \appendix command does not take an argument. It just changes 
the chapter numbering to letters.’ 


laTpX creates a table of contents by taking the section headings and page 
numbers from the last compile cycle of the document. The command 





\tableofcontents 











expands to a table of contents at the place it is issued. A new document 
has to be compiled (“l4TpXed”) twice to get a correct table of contents. 
Sometimes it might be necessary to compile the document a third time. 
I4TReX will tell you when this is necessary. 

All sectioning commands listed above also exist as “starred” versions. A 
“starred” version of a command is built by adding a star * after the command 
name. This generates section headings that do not show up in the table 
of contents and are not numbered. The command \section{Help}, for 
example, would become \section*{Help}. 





"For the article style it changes the section numbering. 
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Normally the section headings show up in the table of contents exactly 
as they are entered in the text. Sometimes this is not possible, because the 
heading is too long to fit into the table of contents. The entry for the table 
of contents can then be specified as an optional argument in front of the 
actual heading. 


\chapter[Title for the table of contents]{A long 
and especially boring title, shown in the text} 


The title of the whole document is generated by issuing a 





\maketitle 











command. The contents of the title have to be defined by the commands 








\title{...}, \author{...} and optionally \datef{...} 








before calling \maketitle. In the argument to \author, you can supply 
several names separated by \and commands. 

An example of some of the commands mentioned above can be found in 
Figure 1.2 on page 8. 

Apart from the sectioning commands explained above, ATRX 2¢ intro- 
duced three additional commands for use with the book class. They are 
useful for dividing your publication. The commands alter chapter headings 
and page numbering to work as you would expect in a book: 


\frontmatter should be the very first command after the start of the doc- 
ument body (\begin{document}). It will switch page numbering to 
Roman numerals and sections will be non-enumerated as if you were 
using the starred sectioning commands (eg \chapter*{Preface}) but 
the sections will still show up in the table of contents. 


\mainmatter comes right before the first chapter of the book. It turns on 
Arabic page numbering and restarts the page counter. 


\appendix marks the start of additional material in your book. After this 
command chapters will be numbered with letters. 


\backmatter should be inserted before the very last items in your book, 
such as the bibliography and the index. In the standard document 
classes, this has no visual effect. 
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A reference to this subsection 
\label{sec:this} looks like: A reference to this subsection looks like: 
~~see section™\ref{sec:this} on “see section 2.8 on page 30.” 

page~\pageref{sec:this}.'' 


Footnotes\footnote{This is 


2.8 Cross References 


In books, reports and articles, there are often cross-references to figures, 
tables and special segments of text. ATX provides the following commands 
for cross referencing 











\label{marker}, \ref{marker} and \pageref {marker} 





where marker is an identifier chosen by the user. IAIfX replaces \ref by 
the number of the section, subsection, figure, table, or theorem after which 
the corresponding \label command was issued. \pageref prints the page 
number of the page where the \label command occurred.* As with section 
titles and page numbers for the table of contents, the numbers from the 
previous compile cycle are used. 














2.9 Footnotes 


With the command 





\footnotetfootnote text} 











a footnote is printed at the foot of the current page. Footnotes should always 
be put? after the word or sentence they refer to. Footnotes referring to a 
sentence or part of it should therefore be put after the comma or period.!” 





Footnotes” are often used by people using 


a footnote.} are often used DTEX. 


by people using \LaTeX. 





“This is a footnote. 











’Note that these commands are not aware of what they refer to. \label just saves the 
last automatically generated number. 
“put” is one of the most common English words. 

Note that footnotes distract the reader from the main body of your document. After all, 
everybody reads the footnotes—we are a curious species, so why not just integrate everything 
you want to say into the body of the document?" 

"A guidepost doesn’t necessarily go where it’s pointing to :-). 
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2.10 Emphasized Words 


If a text is typed using a typewriter, important words are emphasized by 
underlining them. 





\underline{tezt} 











In printed books, however, words are emphasized by typesetting them in 
an italic font. As an author you shouldn’t care either way. The important 
bit is, to tell ATRX that a particular bit of text is important and should be 
emphasized. Hence the command 











\emph{tezt} 





to emphasize text. What the command actually does with its argument 
depends on the context: 


\emph{If you use 





emphasizing inside a piece 
of emphasized text, then 
\LaTeX{} uses the 
\emph{normal} font for 


If you use emphasizing inside a piece of 
emphasized text, then ETRX uses the nor- 
mal font for emphasizing. 








emphasizing. } 


If you want control over font and font size, section 6.2 on page 107 might 
provide some inspiration. 


2.11 Environments 











\beginfenvironment} text \end{environment} 





Where environment is the name of the environment. Environments can be 
nested within each other as long as the correct nesting order is maintained. 


\begin{faaa}...\begin{bbb}...\end{bbb}...\end{aaa} 


In the following sections all important environments are explained. 


2.11.1 Itemize, Enumerate, and Description 


The itemize environment is suitable for simple lists, the enumerate en- 
vironment for enumerated lists, and the description environment for de- 
scriptions. 
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\flushleft 

\beginfenumerate} 

\item You can nest the list 

environments to your taste: 1. You can nest the list environments 
\begin{itemize} to your taste: 

tem pue Ree ere Suey ee e But it might start to look 
look silly. sill 

\item[-] With a dash. o 

\end{itemize} - With a dash. 

\item Therefore remember: 5 “aheratore rabieiaber: 
\begin{description} 

\item[Stupid] things will not Stupid things will not become 
become smart because they are smart because they are in a 
in a list. list. 

\item[Smart] things, Though, Smart things, though, can be 
Gan’ be /presenued beauvatully presented beautifully in a list. 
in a list. 











\end{description} 
\end{enumerate} 


2.11.2 Flushleft, Flushright, and Center 


The environments flushleft and flushright generate paragraphs that 
are either left- or right-aligned. The center environment generates centred 
text. If you do not issue \\ to specify line breaks, ATX will automatically 
determine line breaks. 























\begin{flushleft} 

This text is\\ left-aligned. This text is 

\LaTeX{} is not trying to make left-aligned. EXTRX is not trying to make 
each line the same length. each line the same length. 
\end{flushleft} 

\begin{flushright} 

This text is right-\\aligned. This text is right- 
\LaTeX{} is not trying to make aligned. LTpX is not trying to make each 
each line the same length. line the same length. 
\end{flushright} 

\begin{center} 


At the centre 


At th t f th th 
e centre\\o e ear of the earth 


\end{center} 
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2.11.3 Quote, Quotation, and Verse 


The quote environment is useful for quotes, important phrases and exam- 


ples. 


A typographical rule of thumb 
for the line length is: 
\begin{quote} 

On average, no line should 

be longer than 66 characters. 
\end{quote} 

This is why \LaTeX{} pages have 
such large borders by default 
and also why multicolumn print 
is used in newspapers. 








A typographical rule of thumb for the line 
length is: 


On average, no line should be 
longer than 66 characters. 


This is why TeX pages have such large 
borders by default and also why multicol- 
umn print is used in newspapers. 








There are two similar environments: the quotation and the verse en- 


vironments. The quotation environment is useful for longer quotes going 


over several paragraphs, because it indents the first line of each paragraph. 
The verse environment is useful for poems where the line breaks are im- 
portant. The lines are separated by issuing a \\ at the end of a line and an 


empty line after each verse. 


I know only one English poem by 
heart. It is about Humpty Dumpty. 
\begin{flushleft} 

\begin{verse} 

Humpty Dumpty sat on a wall:\\ 
Humpty Dumpty had a great fall.\\ 
All the King's horses and all 
the King's men\\ 

Couldn't put Humpty together 
again. 

\end{verse} 

\end{flushleft} 


2.11.4 Abstract 








I know only one English poem by heart. 
It is about Humpty Dumpty. 


Humpty Dumpty sat on a 
wall: 

Humpty Dumpty had a 
great fall. 

All the King’s horses and all 
the King’s men 

Couldn’t put Humpty 
together again. 








In scientific publications it is customary to start with an abstract which gives 
the reader a quick overview of what to expect. 4TpX provides the abstract 
environment for this purpose. Normally abstract is used in documents 


typeset with the article document class. 


\beginfabstract} 
The abstract abstract. 
\end{tabstract} 








The abstract abstract. 
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The \verb|\ldots| command \ldots 

The \ldots command ... 
\begin{verbatim} 
Ce EO MOR EDS Ts 10 PRINT "HELLO WORLD "; 
2 GOL 10 20 GOTO 10 
\end{verbatim} 
\begin{verbatim*} 
the starred version of the, starred, version,,of 
the verbatim they uuu sverbatim 
environment emphasizes environment,jemphasizes 
the spaces in the text the, spaces, inthe text 
\end{verbatim*} 


2.11.5 Printing Verbatim 


Text that is enclosed between \begin{verbatim} and \end{verbatim} will 
be directly printed, as if typed on a typewriter, with all line breaks and 
spaces, without any ATRX command being executed. 

Within a paragraph, similar behavior can be accessed with 





\verbttert+ 











The + is just an example of a delimiter character. Use any character except 
letters, * or space. Many ATX examples in this booklet are typeset with 
this command. 























The \verb command can be used in a similar fashion with a star: 





\verb*|like this :-) | like, jthis,:-)y 








The verbatim environment and the \verb command may not be used 
within parameters of other commands. 


2.11.6 Tabular 


The tabular environment can be used to typeset beautiful tables with 
optional horizontal and vertical lines. XTX determines the width of the 
columns automatically. 

The table spec argument of the 





\begin{tabular} [pos] {table spec} 




















command defines the format of the table. Use an |1] for a column of left- 





























aligned text, |r| for right-aligned text, and | c/| for centred text; | p{width} 














2.11 Environments 


35 








for a vertical 


for a column containing justified text with line breaks, and 
line. 











If the text in a column is too wide for the page, ATFX won’t automatically 
wrap it. Using | p{width}]| you can define a special type of column which 
will wrap-around the text as in a normal paragraph. 














The pos argument specifies the vertical position of the table relative to 
the baseline of the surrounding text. Use one of the letters |t |, |b) and |c 
to specify table alignment at the top, bottom or centre. 


























Within a tabular environment, & jumps to the next column, \\ starts 
a new line and \hline inserts a horizontal line. Add partial lines by using 
\cline{i-j}, where i and 7 are the column numbers the line should extend 
over. 


\begin{tabular}{|r|1]|} 



































\hline 

7CO & hexadecimal \\ 70 il Hesadeanall 
3700 & octal \\ \cline{2-2} 3700 | octal 
11111000000 & binary \\ 11111000000 | binary 
\hline \hline 08d dsc 
1984 & decimal \\ 

\hline 

\end{tabular} 


\begin{tabular}{|p{4.7cm}|} 























\hline 

Welcome to Boxy's paragraph. Welcome to Boxy’s paragraph. 
We sincerely hope you'll We sincerely hope you'll all en- 
all enjoy the show.\\ joy the show. 

\hline 

\end{tabular} 


The column separator can be specified with the construct. This 
command kills the inter-column space and replaces it with whatever is be- 
tween the curly braces. One common use for this command is explained 
below in the decimal alignment problem. Another possible application is to 
suppress leading space in a table with | @{} |. 














\begin{tabular}{@{} 1 @{}} 





\hline 
no leading space\\ no leading space 
\hline 








\end{tabular} 
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\begin{tabular}{1} 

\hline 

leading space left and right\\ 
\hline 

\end{tabular} 








leading space left and right 











Since there is no built-in way to align numeric columns to a decimal 
point,!* we can “cheat” and do it by using two columns: a right-aligned inte- 
ger and a left-aligned fraction. The @{.} command in the \begin{tabular} 
line replaces the normal inter-column spacing with just a “.”, giving the ap- 
pearance of a single, decimal-point-justified column. Don’t forget to replace 
the decimal point in your numbers with a column separator (&)! A column 
label can be placed above our numeric “column” by using the \multicolumn 


command. 


\begin{tabular}{c r @{.} 1} 

Pi expression & 
\multicolumn{2}{c}{Value} \\ 
\hline 

$\pi$ & 3&1416 \\ 
$\pi-{\pi}$ & 36&46 = \\ 
$(\pi7{\pi})-{\pil$ & 80662&7 \\ 
\end{tabular} 


\begin{tabular}{|clc|} 
\hline 
\multicolumn{2}{|cl}{Ene} \\ 
\hline 

Mene & Muh! \\ 

\hline 

\end{tabular} 





Pi expression 


Value 








Tv 


a 


(x™)* 


3.1416 
36.46 
80662.7 











Ene 








Mene | Muh! 




















Material typeset with the tabular environment always stays together on 
one page. If you want to typeset long tables, you might want to use the 
longtable environments. 


Sometimes the default ATRX tables do feel a bit cramped. So you 
may want to give them a bit more breathing space by setting a higher 
\arraystretch and \tabcolsep value. 





"Tf the ‘tools’ bundle is installed on your system, have a look at the dcolumn package. 


2.12 Including Graphics and Images 





\begin{tabular}{|1|} 
\hline 
These lines\\\hline 





are tight\\\hline 























\end{tabular} These lines 
are tight 

{\renewcommand{\arraystretch}{1.5} 

\renewcommand{\tabcolsep}{0.2cm} less cramped 

\begin{tabular}{|1|} 

widane table layout 

















less cramped\\\hline 
table layout\\\hline 
\end{tabular}} 


If you just want to grow the height of a single row in your table add an 
invisible vertical bar!’. Use a zero width \rule to implement this trick. 


\begin{tabular}{|cl} 





\hline 
\rule{ipt}{4ex}Pitprop \ldots\\ 
\hline 
\rule{Opt}{4ex}Strut\\ Strut 
\hline 





Pitprop ... 




















\end{tabular} 


The pt and ex in the example above are TFX units. Read more on units 
in table 6.5 on page 114. 

A number of extra commands, enhancing the tabular environment are 
available in the booktabs package. It makes the creation of professional 
looking tables with proper spacing quite a bit simpler. 


2.12 Including Graphics and Images 


As explained in the previous section TeX provides the facilities to work 
with floating bodies, such as images or graphics, with the figure and table 
environments. 

A good set of commands for inclusion of graphics into these floating 
bodies is provided in the graphicx package by D. P. Carlisle. It is part of a 
whole family of packages called the “graphics” bundle.'* 

Use the following step by step guide to include a picture into your doc- 
ument: 


1. Export the picture from your graphics program in EPS, PDF, PNG 
or JPEG format. 





'3In professional typesetting, this is called a strut. 
“CTAN: //pkg/graphics 
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Table 2.3: Key Names for graphicx Package. 





width scale graphic to the specified width 
height scale graphic to the specified height 
angle rotate graphic counterclockwise 
scale scale graphic 








\includegraphics [angle=90,width=\textwidth] {test . png} 





Figure 2.2: Example code for including test. png into a document. 


2. If you exported your graphics as an EPS vector graphics, you have 
to convert it to PDF format prior to using it. There is a epstopdf 
command line tool that helps with this task. Note that it may be 
sensible to export EPS eventhough your software can export PDF too, 
as PDFs often are full page and will thus get very small when imported 
into a document. EPS on the other hand come with a bounding box 
showing the extent of the actual graphics. 


3. Load the graphicx package in the preamble of the input file with 





\usepackage{graphicx} 











4. Use the command 











\includegraphics L[key=value, ...] {file-name} 





to include file into your document. The optional parameter accepts a 
comma separated list of keys and associated values. The keys can be 
used to alter the width, height and rotation of the included graphic. 
Table 2.3 lists the most important keys. 


The example code in figure 2.2 on page 38 may help to clarify things. It 
includes the graphic stored in the file test.png. The graphic is first rotated 
by an angle of 90 degrees and then scaled to the final width of 0.5 times the 
width of a standard paragraph. The aspect ratio is 1.0, because no special 
height is specified. The width and height parameters can also be specified in 
absolute dimensions. Refer to Table 6.5 on page 114 for more information. 
If you want to know more about this topic, make sure to read [9]. 
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2.13 Floating Bodies 


Today most publications contain a lot of figures and tables. These elements 
need special treatment, because they cannot be broken across pages. One 
method would be to start a new page every time a figure or a table is too 
large to fit on the present page. This approach would leave pages partially 
empty, which looks very bad. 

The solution to this problem is to ‘float’ any figure or table that does not 
fit on the current page to a later page, while filling the current page with 
body text. JATRX offers two environments for floating bodies; one for tables 
and one for figures. To take full advantage of these two environments it is 
important to understand approximately how I4TRX handles floats internally. 
Otherwise floats may become a major source of frustration, because ATRX 
never puts them where you want them to be. 


Let’s first have a look at the commands IATFX supplies for floats: 
Any material enclosed in a figure or table environment will be treated 
as floating matter. Both float environments support an optional parameter 











\begin{figure}[placement specifier] or \begin{table}[...] 





called the placement specifier. This parameter is used to tell ATX about the 

locations to which the float is allowed to be moved. A placement specifier is 

constructed by building a string of float-placing permissions. See Table 2.4. 
For example, a table could be started with the following line 


\begin{table}[!hbp] 


The placement specifier [!hbp] allows FTX to place the table right here 
(h) or at the bottom (b) of some page or on a special floats page (p), and 


Table 2.4: Float Placing Permissions. 


Spec Permission to place the float ... 





h here at the very place in the text where it oc- 
curred. This is useful mainly for small floats. 
at the top of a page 

at the bottom of a page 

on a special page containing only floats. 


-'O oOo ct 


without considering most of the internal param- 
eters”, which could otherwise stop this float from 
being placed. 





“Such as the maximum number of floats allowed on one page. 
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all this even if it does not look that good (!). If no placement specifier is 
given, the standard classes assume [tbp]. 

l4TeX will place every float it encounters according to the placement 
specifier supplied by the author. If a float cannot be placed on the current 
page it is deferred either to the figures queue or the tables queue.!? When 
a new page is started, ATpX first checks if it is possible to fill a special 
‘float’ page with floats from the queues. If this is not possible, the first float 
on each queue is treated as if it had just occurred in the text: ATRX tries 
again to place it according to its respective placement specifiers (except ‘h,’ 
which is no longer possible). Any new floats occurring in the text get placed 
into the appropriate queues. IATRX strictly maintains the original order of 
appearance for each type of float. That’s why a figure that cannot be placed 
pushes all further figures to the end of the document. Therefore: 


If AT RX is not placing the floats as you expected, it is often only 
one float jamming one of the two float queues. 


While it is possible to give ATFX single-location placement specifiers, 
this causes problems. If the float does not fit in the location specified it 
becomes stuck, blocking subsequent floats. In particular, you should never, 
ever use the [h] option—it is so bad that in more recent versions of ATRX, 
it is automatically replaced by [ht]. 


Having explained the difficult bit, there are some more things to mention 
about the table and figure environments. Use the 





\caption{caption text} 











command to define a caption for the float. A running number and the string 
“Figure” or “Table” will be added by Tpx. 
The two commands 





\listoffigures and \listoftables 











operate analogously to the \tableofcontents command, printing a list of 
figures or tables, respectively. These lists will display the whole caption, 
so if you tend to use long captions you must have a shorter version of the 
caption for the lists. This is accomplished by entering the short version in 
brackets after the \caption command. 


\caption [Short] {LLLLLoooooonnnnnggggg} 





These are FIFO—first in first out’—queues! 
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Use \label and \ref to create a reference to a float within your text. 
Note that the \label command must come after the \caption command 
since you want it to reference the number of the caption. 

The following example draws a square and inserts it into the document. 
You could use this if you wanted to reserve space for images you are going 
to paste into the finished document. 


Figure~\ref{white} is an example of Pop-Art. 
\begin{figure}[!hbtp] 
\includegraphics [angle=90 , width=\textwidth] {white-box. pdf} 
\caption{White Box by Peter Markus Paulian.\label{white}} 
\end{figure} 


In the example above, ATRX will try really hard (!) to place the figure right 
here (h).'° If this is not possible, it tries to place the figure at the bottom (b) 
of the page. Failing to place the figure on the current page, it determines 
whether it is possible to create a float page containing this figure and maybe 
some tables from the tables queue. If there is not enough material for a 
special float page, ATX starts a new page, and once more treats the figure 
as if it had just occurred in the text. 
Under certain circumstances it might be necessary to use the 








\clearpage or even the \cleardoublepage 








command. It orders ATX to immediately place all floats remaining in the 
queues and then start a new page. \cleardoublepage even goes to a new 
right-hand page. 





‘assuming the figure queue is empty. 


Chapter 3 


Typesetting Mathematical 
Formulae 


Now you are ready! In this chapter, we will attack the main strength of TEX: 
mathematical typesetting. But be warned, this chapter only scratches the sur- 
face. While the things explained here are sufficient for many people, don't 
despair if you can't find a solution to your mathematical typesetting needs here. 
It is highly likely that your problem is addressed in Aj, ,S-IATEX. 


3.1 The Ayy4S-LTpFX bundle 


If you want to typeset (advanced) mathematics, you should use A,4S-LATRX. 
The AjS-IATEX bundle is a collection of packages and classes for mathe- 
matical typesetting. We will mostly deal with the amsmath package which is 
a part of the bundle. A,yS-IATRX is produced by The American Mathemat- 
ical Society and it is used extensively for mathematical typesetting. ATRX 
itself does provide some basic features and environments for mathematics, 
but they are limited (or maybe it’s the other way around: A, S-ATRX is 
unlimited!) and in some cases inconsistent. 

AMS-ETEX is a part of the required distribution and is provided with all 
recent IATpX distributions.' In this chapter, we assume amsmath is loaded 
in the preamble; \usepackage{amsmath}. 


3.2 Single Equations 


A mathematical formula can be typeset in-line within a paragraph (text 
style), or the paragraph can be broken and the formula typeset separately 
(display style). Mathematical equations within a paragraph are entered be- 
tween $ and $: 





‘If yours is missing it, go to CTAN: //pkg/amslatex. 
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Add $a$ squared and $b$ squared 
to get $c$ squared. Or, using 
a more mathematical approach: 
$av2 + b°2 = c72$ 


Add a squared and b squared to get c 
squared. Or, using a more mathematical 
approach: a? + b? = c? 











\TeX{} is pronounced as TeX is pronounced as Tex 
$\tau\epsilon\chi$\\ [5pt] 

100~m$*{3}$ of water\\[5pt] 
This comes from my $\heartsuit$ This comes from my 9 


100 m® of water 








If you want your larger equations to be set apart from the rest of the 
paragraph, it is preferable to display them rather than to break the para- 
graph apart. To do this, you enclose them between \begin{equation} and 
\end{equation}.? You can then \label an equation number and refer to 
it somewhere else in the text by using the \eqref command. If you want to 
name the equation something specific, you \tag it instead. 


Add $a$ squared and $b$ squared 
to get $c$ squared. Or, using 
a more mathematical approach 
\beginfequation} 
av2 + b°2 = c72 
\end{equation} 
Einstein says Einstein says 
\beginfequation} 
E = mc*2 \label{clever} E=mc (3.2) 
\end{equation} 
He didn't say 
\beginfequation} 
1+ 1 = 3 \tag{dumb} 
\end{equation} 
This is a reference to 
\eqref{clever}. 





Add a squared and b squared to get c 
squared. Or, using a more mathematical 
approach 

a+ ac (3.1) 


He didn’t say 
14+1=3 (dumb) 


This is a reference to (3.2). 











If you don’t want I4TeX to number the equations, use the starred ver- 
sion of equation using an asterisk, equation*, or even easier, enclose the 
equation in \[ and \]:° 





>This is an amsmath command. If you don’t have access to the package for some obscure 
reason, you can use 47T#X’s own displaymath environment instead. 

3 This is again from amsmath. Standard MTpX’s has only the equation environment 
without the star. 
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Add $a$ squared and $b$ squared 
to get $c$ squared. Or, using 
a more mathematical approach 
\begin{equation*} 
av2 + b°2 = c72 
\end{equation*} 
or you can type less for the 
same effect: 
\[ a72 + b°2 = c72 \J 








Add a squared and b squared to get c 
squared. Or, using a more mathematical 
approach 

v+Pac 


or you can type less for the same effect: 


at+h=c 








While \[ is short and sweet, it does not allow switching between num- 
bered and not numbered style as easily as equation and equation. 
Note the difference in typesetting style between text style and display 


style equations: 


This is text style: 

$\lim_{n \to \infty} 
\sum_{k=1}-n \frac{1}{k72} 
= \frac{\pi72}{6}$. 

And this is display style: 
\begin{equation} 
\lim_{n \to \infty} 
\sum_{k=1}°n \frac{i}{k-2} 
= \frac{\pi~2}{6} 
\end{equation} 








This is text style: limnoo p-1 = = x. 
And this is display style: 
il 1 
jim pre 63) 








In text style, enclose tall or deep math expressions or sub expressions 
in \smash. This makes 4TfX ignore the height of these expressions. This 


keeps the line spacing even. 


A $d_{e_{e_p}}$ mathematical 
expression followed by a 
$h-{i-{g7h}}$ expression. As 
opposed to a smashed 
\smash{$d_{e_{e_p}}$} expression 
followed by a 


\smash{$h~{i~{g7h}}$} expression. 


3.2.1 Math Mode 








A de. mathematical expression followed 


ch 
by ah expression. As opposed to a 
smashed d., expression followed by a h”” 
expression. 





There are also differences between math mode and text mode. For example, 


in math mode: 


1. Most spaces and line breaks do not have any significance, as all spaces 
are either derived logically from the mathematical expressions, or have 
to be specified with special commands such as \,, \quad or \qquad 
(we'll get back to that later, see section 3.7). 
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2. Empty lines are not allowed. Only one paragraph per formula. 


3. Each letter is considered to be the name of a variable and will be 
typeset as such. If you want to typeset normal text within a formula 
(normal upright font and normal spacing) then you have to enter the 
text using the \text{...} command (see also section 3.8 on page 60). 





$\forall x \in \mathbf{R}: 


: 2 
\qquad x7{2} \geq 0$ Vee R: r2>0 








$x7{2} \geq O\qquad 


2 
\text{for all }x\in\mathbf{R}$ w 20 for alla eR 











Mathematicians can be very fussy about which symbols are used: it 
would be conventional here to use the ‘blackboard bold’ font, which is ob- 
tained using \mathbb from the package amssymb.’ The last example be- 
comes 





$x7{2} \geq 0\qquad 
\text{for all } x x? >0 for alxeER 
\in \mathbb{R}$ 





See Table 3.14 on page 69 and Table 6.4 on page 109 for more math 
fonts. 


3.3. Building Blocks of a Mathematical Formula 


In this section, we describe the most important commands used in mathe- 
matical typesetting. Most of the commands in this section will not require 
amsmath (if they do, it will be stated clearly), but load it anyway. 
Lowercase Greek letters are entered as \alpha, \beta, \gamma, ..., 
uppercase letters are entered as \Gamma, \Delta, ...° 
Take a look at Table 3.2 on page 65 for a list of Greek letters. 





$\lambda, \xi,\pi,\theta, 


\mu , \Phi, \Omega, \Delta$ A657, 8, fy ®,0, A 











Exponents, Superscripts and Subscripts can be specified using the 
~ and the _ characters. Most math mode commands act only on the next 





4amssymb is not a part of the AMS-EIEX bundle, but it is perhaps still a part of your 
TeX distribution. Check your distribution or go to CTAN:/fonts/amsfonts/latex/ to 
obtain it. 

°There is no uppercase Alpha, Beta etc. defined in KTpX 2¢ because it looks the same as 
a normal roman A, B... 
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character, so if you want a command to affect several characters, you have 
to group them together using curly braces: {...}. 
Table 3.3 on page 66 lists a lot of binary relations like C and L. 


$p°3_{ij} \qquad 
m_\text{Knuth}\qquad 

\sum_{k=1}°3 k \\[5pt] 
avxty \neq a7*{x+y}\qquad aX +yA#arty ew + et? 
e~{x72} \neq {e7x}72$ 





3 3 
Py ™MKnuth YS k 








The square root is entered as \sqrt; the n™ root is generated with 


\sqrt[n]. The size of the root sign is determined automatically by ATpRX. 
If just the sign is needed, use \surd. 
See various kinds of arrows like ~ and = on Table 3.6 on page 67. 


$\sqrt{x} \Leftrightarrow x7{1/2} 


\quad \sqrt [3] {2} ; 
\quad \sqrt{x7{2} + \sqrt{y}} Jean? ¥2 Je+/y J[a? +y?] 


\quad \surd[x72 + y72]$ 











While the dot sign to indicate the multiplication operation is normally 
left out, it is sometimes written to help the eye in grouping a formula. Use 
\cdot to typeset a single centered dot. \cdots is three centered dots while 
\ldots sets the dots low (on the baseline). Besides that, there are \vdots 
for vertical and \ddots for diagonal dots. There are more examples in 
section 3.6. 


$\Psi = v_1 \cdot v_2 
\cdot \ldots \qquad 
n! = 1 \cdot 2 
\cdots (n-1) \cdot n$ 








W =v 1-V9-... n!=1-2---(n—1)-n 





The commands \overline and \underline create horizontal lines 
directly over or under an expression: 





$0.\overline{3} = 0.3 =1/3 
\underline{\underline{1/3}}$ = 








The commands \overbrace and \underbrace create long horizontal 
braces over or under an expression: 





$\underbrace{\overbrace{fatbt+c}76 : ig 


———_S 

\cdot \overbrace{dt+et+f}~7} at+tb+e-d+e+ f=42 
: : -—_—.,—_—_" 

_\text{meaning of life} = 42$ 


meaning of life 
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To add mathematical accents such as small arrows or tilde signs to 
variables, the commands given in Table 3.1 on page 65 might be useful. Wide 
hats and tildes covering several characters are generated with \widetilde 
and \widehat. Notice the difference between \hat and \widehat and the 
placement of \bar for a variable with subscript. The apostrophe mark ' 


gives a prime: 


$f (x) = x72 \qquad f' (x) 

= 2x \qquad f''(x) = 2\\[5pt] 
\hat{XY} \quad \widehat{XY} 
\quad \bar{x_0} \quad \bar{x}_0$ 








f(@@)=a? fi@)=2e f"(x) =2 
XY XY %% Zp 





Vectors are often specified by adding small arrow symbols on the tops 
of variables. This is done with the \vec command. The two commands 
\overrightarrow and \overleftarrow are useful to denote the vector from 


Ato B: 


$\vec{a} \qquad 
\vec{AB} \qquad 
\overrightarrow{AB}$ 





a 





AB AB 





Names of functions are often typeset in an upright font, and not in italics 
as variables are, so IATRX supplies the following commands to typeset the 


most common function names: 
\arccos \cos \csc 


\arcsin \cosh \deg 


\arctan \cot \det 
\arg \coth \dim 
\sinh \sup \tan 
\sec \sin 
\beginfequation*} 


\lim_{x \rightarrow 0} 
\frac{\sin x}{x}=1 
\end{equation*} 








\exp  \ker \limsup 
\gcd \lg \ln 
\hom \lim \log 
\inf \liminf \max 
\tanh \min \Pr 

_ sing 

lim =1 

z->0 








For functions missing from the list, use the \DeclareMathOperator com- 
mand. There is even a starred version for functions with limits. This com- 
mand works only in the preamble so the commented lines in the example 
below must be put into the preamble. 


%4\DeclareMathOperator{\argh}{argh} 
%4\DeclareMathOperator*{\nut}{Nut} 
\beginfequation*} 

3\argh = 2\nut_{x=1} 
\end{equation*} 








3argh = 2 Nut 
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For the modulo function, there are two commands: \bmod for the binary 
operator “a mod b” and \pmod for expressions such as “x = a (mod 6):” 





$a\bmod b \\ 
x\equiv a \pmod{b}$ 


a mod b 
x =a (mod b) 





A built-up fraction is typeset with the \fracf{...}{...} command. In 
in-line equations, the fraction is shrunk to fit the line. This style is obtainable 
in display style with \tfrac. The reverse, i.e. display style fraction in text, 
is made with \dfrac. Often the slashed form 1/2 is preferable, because it 


looks better for small amounts of ‘fraction material:’ 


In display style: 
\beginfequation*} 
3/8 \qquad \frac{3}{8} 
\qquad \tfrac{3}{8} 
\endf{equation*} 


In text style: 
$1\frac{1}{2}$~hours \qquad 
$1\dfrac{1}{2}$~hours 








In display style: 

















Here the \partial command for partial derivatives is used: 


\beginfequation*} 
\sqrt{\frac{x72}{k+1}}\qquad 
x7\frac{2}{k+1}\qquad 
\frac{\partial~2f} 

{\partial x72} 

\end{equation*} 











3 3 
3/8 3 : 
1 1 
In text style: 15 hours 15 hours 
gee ‘ee 
k+1 Ox? 








To typeset binomial coefficients or similar structures, use the command 


\binom from amsmath: 


Pascal's rule is 
\beginfequation*} 
\binom{n}{k} =\binom{n-1}{k} 
+ \binom{n-1}{k-1} 
\end{equation*} 








Pascal’s rule is 


eee) 





For binary relations it may be useful to stack symbols over each other. 
\stackrel{#1}{#2} puts the symbol given in #1 in superscript-like size over 


#2 which is set in its usual position. 


\beginfequation*} 
f_n(x) \stackrel{*}{\approx} 1 
\end{equation*} 








fr(z) 21 
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The integral operator is generated with \int, the sum operator with 
\sum, and the product operator with \prod. The upper and lower limits 
are specified with ~ and _ like superscripts and subscripts: 





\beginfequation*} 

\sum_{i=1}7n \qquad n z 
\int_0~{\frac{\pi}{2}} \qquad 3 | Il 
\prod_\epsilon i=1 0 € 
\end{equation*} 








To get more control over the placement of indices in complex expressions, 
amsmath provides the \substack command: 





\beginfequation*} 
\sum*n_{\substack{0<i<n \\ a _ ne 
j\subseteq i}} yD P(i,j) = Qi, 3) 
P(i,j) = Q(i,j) Se" 
\end{equation*} 








I4TeX provides all sorts of symbols for bracketing and other delim- 
iters (e.g. [ ( || ¢). Round and square brackets can be entered with the 
corresponding keys and curly braces with \{, but all other delimiters are 
generated with special commands (e.g. \updownarrow). 





\beginfequation*} 
{a,b,c} \neq \{a,b,c\} a,b,c # {a, b, c} 
\end{equation*} 








If you put \left in front of an opening delimiter and \right in front 
of a closing delimiter, AT@X will automatically determine the correct size of 
the delimiter. Note that you must close every \left with a corresponding 
\right. If you don’t want anything on the right, use the invisible “\right .”: 


\begin{fequation*} 

1 + \left(\frac{1}{1-x°{2}} 3 
\right)~3 \qquad 1+ (<3) t-) 

\left. \ddagger \frac{~}{7}\right) 

\end{equation*} 











In some cases it is necessary to specify the correct size of a mathematical 
delimiter by hand, which can be done using the commands \big, \Big, 
\bigg and \Bigg as prefixes to most delimiter commands: 








$\Big((x+1) (x-1) \Big) *{2}$\\ 

$\big( \Big( \bigg( \Bigg( \quad (w+ 1)(e—1))" 

\big\} \Big\} \bigg\} \Bigg\} \quad 

\biz\ [> \Big\ | \bige\| \Bige\) \quad (( i} ill ull 
\big\Downarrow \Big\Downarrow 

\bigg\Downarrow \Bigg\Downarrow$ 
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For a list of all delimiters available, see Table 3.8 on page 68. 
3.4 Single Equations that are Too Long: 
multline 
If an equation is too long, we have to wrap it somehow. Unfortunately, 
wrapped equations are usually less easy to read than not wrapped ones. To 
improve the readability, there are certain rules on how to do the wrapping: 
1. In general one should always wrap an equation before an equality sign 
or an operator. 
2. A wrap before an equality sign is preferable to a wrap before any 
operator. 
3. A wrap before a plus- or minus-operator is preferable to a wrap before 
a multiplication-operator. 
4. Any other type of wrap should be avoided if at all possible. 
The easiest way to achieve such a wrapping is the use of the multline 
environment:° 
\begin{multline} 
at+b+tct+tdtetf 
h i : 
i = at+b+ctd+e+ftgth+i 
=j+k+ltmin =jtk+l+m+n (3.4) 
\end{multline} 


The difference from the equation environment is that an arbitrary line- 
break (or also multiple line-breaks) can be introduced. This is done by 
putting a \\ on those places where the equation needs to be wrapped. Sim- 
ilarly to equation* there also exists a multline* version for preventing an 


equation number. 


Often the IEEEeqnarray environment (see section 3.5) will yield better 


results. Consider the following situation: 


\beginfequation} 





a=btct+dtertf 
+gth+it+j 
t+k+1l+m+nt+0+)p 
\labelfeq:equation_too_long} 





a = b+c+d+e+ftg+th+itj+k+tl+m+n+o 





(3.5) 








\end{equation} 





°The multline-environment is from amsmath. 


rp 
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Here it is actually the RHS that is too long to fit on one line. The multline 
environment creates the following output: 








\begin{multline} 
a=btct+dtet+f 
+gthti+j\\ a=b+ct+d+e+ftgtht+it+] 
t+k+il+mtntot+p +k+l+m+n+ot+p (3.6) 
\end{multline} 





This is better than (3.5), but it has the disadvantage that the equality 
sign loses its natural greater importance with respect to the plus operator in 
front of k. The better solution is provided by the IEEEeqnarray environment 
that will be discussed in detail in Section 3.5. 


3.5 Multiple Equations 


In the most general situation we have a sequence of several equalities that 
do not fit onto one line. Here we need to work with vertical alignment in 
order to keep the array of equations in a nice and readable structure. 
Before we offer our suggestions on how to do this, we start with a few 
bad examples that show the biggest drawbacks of some common solutions. 


3.5.1 Problems with Traditional Commands 


To group multiple equations the align environment’ could be used: 





\begin{falign} 

a&=btcec \\ = 

k=dte are ( 
\end{align} =dt+e (3.8 








this approach fails once a single line is too long: 











\begin{align} 
ak=btec\\ 
&k=dt+et+ft+tgthti a=b+e (3.9) 
+ j + k + 1 \nonumber \\ =d+e+f+gtht+itj+ktl 
&+mt+nto \\ +mt+n+o (3.10) 
&k&=p+t+qtrts Sig eis 11 
\end{align} Eee aa 














"The align-environment can also be used to group several blocks of equations beside each 
other. Another excellent use case for the IEEEeqnarray environment. Try an argument like 
{rCl+rCl1}. 
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Here + m should be below d and not below the equality sign. A TRrXpert 
will point out that \mathrel{\phantom{=}} \negmedspace {}, would add 
the necessary space in front of +m+nt+o, but since most users lack that kind 
of imagination, a simpler solution would be nice. 
This is the moment where the eqnarray environment bursts onto the 
scene: 
\beginfeqnarray} 
ak&=&btc\\ 
&=&dtetf+gthti a= bte (3.12) 
+ j + k + 1 \nonumber \\ = d+e+f+gtht+i+j+k+l 
&& +\: m+nto \\ t+mtnto (3.13) 
&=€&pt+tqatrits = sate 
\end{eqnarray} ee ahs pees 4) 
It is better but still not optimal. The spaces around the equality signs 
are too big. Particularly, they are not the same as in the multline and 
equation environments: 
\beginfeqnarray} 
ak&=&a=a 
\end{eqnarray} a= a=a (3.15) 
..and the expression sometimes overlaps with the equation number even 
though there would be enough room on the left: 
\beginfeqnarray} 
a&=&bte 
\\ 
k=&dtet+tf+g+h2 a = b+e (3.16) 
ee = dtet+ft+gth? +7 49.17) 
\label{eq:faultyeqnarray} 
\end{eqnarray} 


While the environment offers a command \leftegn that can be used when 
the LHS is too long: 





\begin{feqnarray} 
\lefteqnfa+b+ct+d 
+ e+ £ + g + h}\nonumber\\ 


: : at+b+e+dt+et+tft+gth 
&=€it+jtrtk+its+n 





\\ = itjtktltm (3.18) 
&=k&ntotptgqtrts = ntotptqtrts (3.19) 
\end{eqnarray} 





This is not optimal either as the RHS is too short and the array is not 
properly centered: 
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\beginfeqnarray} 
\lefteqnfa+b+c+d 


tet+f+gert h} 
\nonumber \\ a+b+ct+d+e+ft+tgt+h 


&=&itrj = i+] (3.20) 
\end{eqnarray} 














Having badmouthed the competition sufficiently, I can now steer you gently 
towards the glorious ... 


3.5.2 [EEEeqnarray Environment 


The IEEEeqnarray environment is a very powerful command with many 
options. Here, we will only introduce its basic functionalities. For more 
information please refer to the manual.® 

First of all, in order to be able to use the IEEEeqnarray environment 
one needs to load the package’ IEEEtrantools. Include the following line in 
the header of your document: 


\usepackage{IEEEtrantools} 


The strength of IEEEeqnarray is the ability to specify the number of 
columns in the equation array. Usually, this specification will be {rCl}, 
i.e., three columns, the first column right-justified, the middle one centered 
with a little more space around it (therefore we specify capital C instead of 
lower-case c) and the third column left-justified: 


\begin{IEEEeqnarray}{rCl} 

















ak&=&bte 

\\ 

k=-&dtet+ft+g_gth a=b+c (3.21) 

+ i+ j + k \nonumber\\ =d+e+ftgth+i+j+k 

. \negmedspace {} +1+m+t+n+o0 4+14+m4n+o (3.22) 

&k=k&ptqtris oe a a (3.23) 
\end{IEEEeqnarray} 


Any number of columns can be specified: {c} will give only one column 
with all entries centered, or {rC11} would add a fourth, left-justified column 
to use for comments. Moreover, beside 1, c, r, L, C, R for math mode 
entries there are also s, t, u for left, centered, and right text mode entries. 
Additional space can be added with . and / and ? in increasing order.!” 
Note the spaces around the equality signs in contrast to the space produced 
by the eqnarray environment. 





8The official manual is called CTAN://macros/latex/contrib/IEEEtran/IEEEtran_ 
HOWTO.pdf. The part about IEEEeqnarray can be found in Appendix F. 

°The IEEEtrantools package may not be included in your setup, it can be found on CTAN. 

For more spacing types refer to Section 3.9.1. 
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3.5.3 Common Usage 


In the following we will describe how we use IEEEeqnarray to solve the most 


common problems. 
If a line overlaps with the equation number as in (3.17), the command 


\IEEEeqnarraynumspace 


can be used: it has to be added in the corresponding line and makes sure 
that the whole equation array is shifted by the size of the equation numbers 
(the shift depends on the size of the number!): instead of 


\begin{IEEEeqnarray}{rCl} 
agkg=&btec 

\\ 
&=k&dte+ftgth a=b+c (3.24) 
+i+jt+k =d+e+f+gth+i+j+®.25) 
i =l+m+n (3.26) 
&=&lt+mtn 
\end{IEEEeqnarray} 














we get 


\begin{IEEEeqnarray}{rCl} 
ag=&btec 





\\ 

&=k&dte+ftgth a=b+e (3.27) 
ue ee ae =d+e+ft+gthtit+jg+k (3.28) 
\IEEEeqnarraynumspace\\ sf La dene. (3.29) 


&=&€&lt+min. 











\end{IEEEeqnarray} 


If the LHS is too long, as a replacement for the faulty \lefteqn com- 
mand, IEEEeqnarray offers the \IEEEeqnarraymulticol command which 
works in all situations: 


\begin{IEEEeqnarray}{rCl} 
\IEEEeqnarraymulticol{3}{1}{ 











atbt+tct+dtet+f 
+gt+h 
cree \quad a ae are 
&=k&itrj =i+] (3.30) 
\\ =k+l+m (3.31) 
&=&k+1li+m 
\end{IEEEeqnarray} 


The usage is identical to the \multicolumns command in the tabular- 
environment. The first argument {3} specifies that three columns shall be 
combined into one which will be left-justified {1}. 
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Note that by inserting \quad commands one can easily adapt the depth 


of the equation signs,'! e.g., 


\begin{IEEEeqnarray}{rCl} 
\IEEEeqnarraymulticol{3}{l}{ 





atb+tcot+tdter+f 
+gth 
}\nonumber\\ \qquad\qquad 
&k=K&itrj 
\\ 
&=&k+1lt+om 





a+b+et+d+e+f+gt+h 
=i+j (3.32) 
=k+l+m (3.33) 





\end{IEEEeqnarray} 


If an equation is split into two or more lines, IATRX interprets the first 
+ or — as a sign instead of operator. Therefore, it is necessary to add an 


empty group {} before the operator: instead of 


\begin{IEEEeqnarray}{rCl} 





ak=&btc 
\\ 




















&k=k&dt+te+f+eth a=bt+e (3.34) 
+ i+ j + k \nonumber\\ =d+e+ftgth+i+j+k 
eens +l+m+tn+o (3.35) 
&k=&ptqtrits ae ee ao ee (3.36) 
\end{IEEEeqnarray} 
we should write 
\begin{IEEEeqnarray}{rC1} 
ak&=&bte 
\\ 
&=k&dte+ftgeth a=b+c (3.37) 
+ i+ j + k \nonumber\\ =d+e+ftgth+i+j+k 
&& \negmedspace {} +l1+m+nt+o0 4+1l+m4n+o (3.38) 
_ =pt+qtrt+s (3.39) 


&k&=&€prqatrts 











\end{IEEEeqnarray} 


Note the space difference between + and /! The construction {} + 1 forces 
the +-sign to be an operator rather than just a sign, and the unwanted 
ensuing space between {} and + is compensated by a negative medium space 


\negmedspace. 


If a particular line should not have an equation number, the number can 
be suppressed using \nonumber (or \IEEEnonumber). If on such a line a 
label \label{eq:...} is defined, then this label is passed on to the next 





"T think that one quad is the distance that looks good for most cases. 
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equation number that is not suppressed. Place the labels right before the 
line-break \\ or the next to the equation it belongs to. Apart from improving 
the readability of the source code this prevents a compilation error when a 
\IEEEmulticol command follows the label-definition. 
There also exists a *-version where all equation numbers are suppressed. 

In this case an equation number can be made to appear using the command 
\IEEEyesnumber: 
\begin{IEEEeqnarray*}{rCl} 

ak&=&btc\\ eh tee 

& = & d + e \IEEEyesnumber\\ 

&=-&ft+g =dt+e (3.40) 
\end{IEEEeqnarray*} =Jrg 

Sub-numbers are also easily possible using \IEEEyessubnumber: 

\begin{IEEEeqnarray}{rCl} 

a&=&bte 

\IEEEyessubnumber \\ 

&=k&dte a=b+c (3.40a) 

\nonumber\\ =f tie 

&=&ft+g APG, 3 40b 

\IEEEyessubnumber i+g (a0) 
\end{IEEEeqnarray} 


3.6 Arrays and Matrices 


To typeset arrays, use the array environment. It works in a similar way to 
the tabular environment. The \\ command is used to break the lines: 


\begin{equation*} 
\mathbf{X} = \left( 
\begin{array}{ccc} 
x_l & x_2 & \ldots \\ 
x_3 & x_4 & \ldots \\ 
\vdots & \vdots & \ddots 
\end{array} \right) 
\endfequation*} 











The array environment can also be used to typeset piecewise functions 


(ae) 


by using a “.” as an invisible \right delimiter: 
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\beginfequation*} 
Ix| = \left\{ 
\beginfarray}{rl} F 
-x & \text{if } x < 0,\\ mae aes 
0 & \text{if } x = 0,\\ le ela. 
x & \text{if } x > 0. eae 








\end{array} \right. 
\end{equation*} 


The cases environment from amsmath simplifies the syntax, so it is 
worth a look: 


\beginfequation*} 
Ix| = 
\begin{cases} —r ife#<0 

-x & \text{if } x < 0,\\ ; 

0 & \text{if } x = 0,\\ we ae 

x & \text{if } x > 0. e ife>0. 
\end{cases} 
\end{equation*} 











Matrices can be typeset by array, but amsmath provides a better solu- 
tion using the different matrix environments. There are six versions with dif- 
ferent delimiters: matrix (none), pmatrix (, bmatrix [, Bmatrix {, vmatrix 
| and Vmatrix ||. You don’t have to specify the number of columns as with 
array. The maximum number is 10, but it is customisable (though it is not 
very often you need 10 columns!): 


\beginfequation*} 
\begin{matrix} 

1&2 \\ 

3&4 
\end{matrix} \qquad 
\begin{bmatrix} 

p_{11} & p_{12} & \ldots Bis Bis oan Die 

& p_tin} \\ P21 P22 «++ Pan 

p_{21} & p_{22} & \ldots ‘ ; ; 

& p_{2n} \\ : : 

\vdots & \vdots & \ddots Pm1 Dm2 +--+» Pmn 

& \vdots \\ 

p_{mi} & p_{m2} & \ldots 

& p_{mn} 

\end{bmatrix} 
\end{equation*} 





Wr 
me dO 
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3.7 Spacing in Math Mode 


If the spacing within formulae chosen by IATRX is not satisfactory, it can be 
adjusted by inserting special spacing commands: \, for = quad (lu), \: for 
ig quad (u) and \; for 7 quad (u). The escaped space character \,, generates 
a medium sized space comparable to the interword spacing and \quad (\_)) 
and \qquad (|__|) produce large spaces. The size of a \quad corresponds 
to the width of the character ‘M’ of the current font. \! produces a negative 
space of a quad (-1). 


\beginfequation*} 





\int_1°2 \ln x \mathrm{d}x 


2 2 
\qquad / Inadz | Inadzx 
\int_172 \ln x \,\mathrm{d}x i 1 








\end{equation*} 


Note that ‘d’ in the differential is conventionally set in roman. In the 
next example, we define a new command \ud (upright d) which produces 
“dq” (notice the spacing |) before the d), so we don’t have to write it every 
time. The \newcommand is placed in the preamble. 


\newcommand{\ud}{\, \mathrm{d}} 





b 
\begin{equation*} / f(x) da 
\int_a7b f(x)\ud x a 








\end{equation*} 


If you want to typeset multiple integrals, you’ll discover that the spacing 
between the integrals is too wide. You can correct it using \!, but ams- 
math provides an easier way for fine-tuning the spacing, namely the \iint, 
\iiint, \iiiint, and \idotsint commands. 





\newcommand{\ud}{\, \mathrm{d}} 





\begin{IEEEegnarray*}{c} - ana 
\int\int f(x)g(y) f(x)g(y) dx dy 
\ud x \ud y \\ 
\int\!\!\!\int | { #@aw axay 
f(x)g(y) \ud x \ud y \\ 
\iint £(x)g(y) \ud x \ud y // f(x)g(y) dx dy 
\end{IEEEeqnarray*} 








See the electronic document testmath. tex (distributed with A, 4S-ATEX) 
or Chapter 8 of The ATRX Companion [3] for further details. 
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3.7.1 Phantoms 


When vertically aligning text using ~ and _ IATRX is sometimes just a little 
too helpful. Using the \phantom command you can reserve space for charac- 
ters that do not show up in the final output. The easiest way to understand 
this is to look at an example: 


\beginfequation*} 
{}°{14}_{6}\text {Cc} 
\qquad \text{versus} \qquad ae ereug 14Q 
{}-{14}_{\phantom{1}6}\text{C} 
\end{equation*} 











If you want to typeset a lot of isotopes as in the example, the mhchem 
package is very useful for typesetting isotopes and chemical formulae too. 


3.8 Fiddling with the Math Fonts 


Different math fonts are listed on Table 3.14 on page 69. 


$\Re \qquad 
\mathcal{R} \qquad 
\mathfrak{R} \qquad 
\mathbb{R} \qquad $ 











The last two require amssymb or amsfonts. 
Sometimes you need to tell TeX the correct font size. In math mode, 
this is set with the following four commands: 


\displaystyle (123), \textstyle (123), \scriptstyle (123) and 
\scriptscriptstyle (123). 


If $> is placed in a fraction, it’ll be typeset in text style unless you tell 
IATRX otherwise: 


\beginfequation*} 

P = \frac{\displaystylef{ 
\sum_{i=1}°n (x_i- x) n 
(y_i- y)} doi - 2)(yi - 9) 
{\displaystyle{\left[ Pe i=1 
\sum_{i=1}°n(x_i-x)*2 n n 
\sum_{i=1}-n(y_i- y)*2 S(ai — 2)? SO(yi - 9)? 
\right]~{1/2}}} i=1 i=l 

\end{equation*} 

















Changing styles generally affects the way big operators and limits are 
displayed. 
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3.8.1 Bold Symbols 


It is quite difficult to get bold symbols in AATRX; this is probably intentional 
as amateur typesetters tend to overuse them. The font change command 
\mathbf gives bold letters, but these are roman (upright) whereas math- 
ematical symbols are normally italic, and furthermore it doesn’t work on 
lower case Greek letters. There is a \boldmath command, but this can only 
be used outside math mode. It works for symbols too, though: 





$\mu, M \qquad 
\mathbf{\mu}, \mathbf{M}$ Lb, M pL, M pe, M 








\qquad \boldmath{$\mu, M$} 


The package amsbsy (included by amsmath) as well as the package bm 
from the tools bundle make this much easier as they include a \boldsymbol 
command: 





$\mu, M \qquad 


\boldsymbol{\mu}, \boldsymbol{M}$ uM bh, M 











3.9 Theorems, Lemmas, ... 


When writing mathematical documents, you probably need a way to typeset 
“Lemmas”, “Definitions”, “Axioms” and similar structures. 











\newtheorem{name} Lcounter] {text} [section] 





The name argument is a short keyword used to identify the “theorem”. 
With the text argument you define the actual name of the “theorem”, which 
will be printed in the final document. 

The arguments in square brackets are optional. They are both used to 
specify the numbering used on the “theorem”. Use the counter argument 
to specify the name of a previously declared “theorem”. The new “theorem” 
will then be numbered in the same sequence. The section argument allows 
you to specify the sectional unit within which the “theorem” should get its 
numbers. 

After executing the \newtheorem command in the preamble of your doc- 
ument, you can use the following command within the document. 


\begin{name} [tert] 
This is my interesting theorem 
\end{name} 


The amsthm package (part of A,4S-ATRX) provides the \theoremstyle{ style} 


command which lets you define what the theorem is all about by picking from 
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three predefined styles: definition (fat title, roman body), plain (fat title, 
italic body) or remark (italic title, roman body). 

This should be enough theory. The following examples should remove 
any remaining doubt, and make it clear that the \newtheorem environment 
is way too complex to understand. 

First define the theorems: 


\theoremstyle{definition} \newtheorem{law}{Law} 
\theoremstyle{plain} \newtheorem{jury} [law] {Jury} 
\theoremstyle{remark} \newtheorem*{marg}{Margaret} 








\beginflaw} \label{law: box} 

Don't hide in the witness box Law 1. Don’t hide in the witness box 
\end{law} 

\begin{jury}[The Twelve] Jury 2 (The Twelve). It could be you! So 
It could be you! So beware and beware and see law 1. 

see law~\ref{law:box}.\end{jury} 

\begin{ jury} Jury 3. You will disregard the last state- 
You will disregard the last ment. 


statement. \end{jury} 
\begin{marg}No, No, No\end{marg} 
\begin{marg}Denis! \end{marg} Margaret. Denis! 


Margaret. No, No, No 











The “Jury” theorem uses the same counter as the “Law” theorem, so it 
gets a number that is in sequence with the other “Laws”. The argument 
in square brackets is used to specify a title or something similar for the 
theorem. 





\newtheorem{mur}{Murphy} [section] 


\begin{mur} If there are two or Murphy 3.9.1. If there are two or more 
more ways to do something, and ways to do something, and one of those 
one of those ways can result in ways can result in a catastrophe, then 
a catastrophe, then someone someone will do it. 








will do it.\end{mur} 


The “Murphy” theorem gets a number that is linked to the number of 
the current section. You could also use another unit, for example chapter 
or subsection. 

If you want to customize your theorems down to the last dot, the nthe- 
orem package offers a plethora of options. 


3.9.1 Proofs and End-of-Proof Symbol 


The amsthm package also provides the proof environment. 
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\begin{proof} 
Trivial, use 
\begin{equation*} 

E=mc7~2. 
\end{equation*} 
\end{proof} 








Proof. Trivial, use 


E=me’. 

















With the command \gedhere you can move the ‘end of proof’ symbol 
around for situations where it would end up alone on a line. 


\begin{proof} 
Trivial, use 
\begin{equation*} 

E=mc72. \qedhere 
\end{equation*} 
\end{proof} 








Proof. Trivial, use 


E=me’. 




















Unfortunately, this correction does not work for IEEEeqnarray: 


\begin{proof} 
This is a proof that ends 
with an equation array: 
\begin{IEEEeqnarray*}{rCl} 
ak=&bt+c\\ 
& =&d+e. \qgedhere 
\end{IEEEeqnarray*} 
\end{proof } 








Proof. This is a proof that ends with an 
equation array: 


a=b+ec 
=d+e. 




















The reason for this is the internal structure of IEEEeqnarray: it always 
puts two invisible columns at both sides of the array that only contain a 
stretchable space. By this IEEEeqnarray ensures that the equation array 
is horizontally centered. The \qedhere command should actually be put 
outside this stretchable space, but this does not happen as these columns 


are invisible to the user. 


There is a very simple remedy. Define the stretching explicitly! 


\begin{proof} 
This is a proof that ends 
with an equation array: 
\begin{IEEFeqnarray*}{+rCl+x*} 
ak=&b+c\\ 
&=&d+e. & \gedhere 
\end{IEEEeqnarray*} 
\end{proof} 








Proof. This is a proof that ends with an 
equation array: 

a=b+c 

=d+e. 

















Note that the + in {+rCl+x*} denotes stretchable spaces, one on the left 
of the equations (which, if not specified, will be done automatically by 
IEEEeqnarray!) and one on the right of the equations. But now on the 
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right, after the stretching column, we add an empty column x. This column 
will only be needed on the last line if the \qedhere command is put there. 
Finally, we specify a *. This is a null-space that prevents IEEEeqnarray 


from adding another unwanted +-space! 


In the case of equation numbering, there is a similar problem. Comparing 





\begin{proof} 


This is a proof that ends Proof. This is a proof that ends with a 


with a numbered equation: numbered equation: 
\begin{equation} 
ay= bot es 
\end{equation} 
\end{proof } 





a=b+e. (3.41) 




















with 





\begin{proof} 


This is a proof that ends Proof. This is a proof that ends with a 


with a numbered equation: numbered equation: 
\begin{equation} 


a=b +c. \qedhere a=b+e. (3.42) 


\end{equation} 
\end{proof } 


























you notice that in the (correct) second version the 








equation than in the first version. 


is much closer to the 


Similarly, the correct way of putting the QED-symbol at the end of an 


equation array is as follows: 





\begin{proof} 
This is a proof that ends 
with an equation array: 


equation array: 
\begin{IEEEeqnarray}{+rCl+x*} - o 


ak&=&btc\\ a=b+ce 3.43) 
=dte. (3.44) 


&=&dte. \\ 
&&& \qedhere\nonumber 
\end{IEEEeqnarray} 





Proof. This is a proof that ends with an 




















\end{proof} 


which contrasts with 





\begin{proof} 
This is a proof that ends 
with an equation array: 
\begin{IEEEeqnarray}{rCl} 
ak=&bt+c\\ 


equation array: 


\end{IEEEeqnarray} 
\end{proof} 





Proof. This is a proof that ends with an 


a=b+c (3.45) 
e=kdte. =d+e. (3.46) 
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3.10 List of Mathematical Symbols 


The following tables demonstrate all the symbols normally accessible from 
math mode. 

Note that some tables show symbols only accessible after loading the 
amssymb package in the preamble of your document!?. If the Aa4S pack- 
age and fonts are not installed on your system, have a look at CTAN:pkg/ 
amslatex. An even more comprehensive list of symbols can be found at 
CTAN: info/symbols/comprehensive. 


Table 3.1: Math Mode Accents. 


a \hat{a} a \check{a} a \tilde{a} 

a \gravefa} a \dot{a} a \ddot{a} 

a \bar{a} a@ \vect{a} AAA \widehat {AAA} 

a \acutefa} a \breveta} AAA \widetilde{AAA} 
a \mathring{a} 


Table 3.2: Greek Letters. 


There is no uppercase of some of the letters like \Alpha, \Beta and so on, 
because they look the same as normal roman letters: A, B... 


a \alpha § \theta Ce) vu \upsilon 
B \beta 0 \vartheta am \pi bo \phi 

y \gamma t \iota ao \varpi y \varphi 
6 \delta & \kappa p  \rho x \chi 

€ \epsilon A \lambda o  \varrho w \psi 

€ \varepsilon wp \mu o \sigma w \omega 
¢ \zeta y \nu s \varsigma 

7 \eta € \xi 7 \tau 

T \Gamma A \Lambda = \Sigma WwW \Psi 

A \Delta = \Xi Y \Upsilon Q \Omega 
© \Theta II \Pi ® \Phi 





The tables were derived from symbols. tex by David Carlisle and subsequently changed 
extensively as suggested by Josef Tkadlec. 
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Table 3.3: Binary Relations. 


You can negate the following symbols by prefixing them with a \not com- 


mand. 





IAA P®SOP<CLC xX 


< 

\leq or \le 
\11 

\prec 
\preceq 
\subset 
\subseteq 
\sqsubset ° 
\sqsubseteq 


NIMNNINAILPK AIA A 


\in 
-  \vdash 
| \mid 
\smile 





> 

\geq or \ge 
\gg 

\succ 
\succeq 
\supset 
\supseteq 
\sqsupset * 
\sqsupseteq 


YVIJUWUIY Y VIV Vv 


\ni , \owns 
4 \dashv 
|| \parallel 
\frown 
¢ \notin 





2 (le 


I 


tT R&R X X lke v 


\equiv 
\doteq 
\sim 
\simeq 
\approx 
\cong 
\Join 
\bowtie 
\propto 
\models 
\perp 
\asymp 
\neq or \ne 


“Use the latexsym package to access this symbol 


Table 3.4: Binary Operators. 


+ 4 


\pm 

\cdot 
\times 
\cup 
\sqcup 
\vee , \lor 
\oplus 
\odot 
\otimes 
\bigtriangleup 
\lhd ° 
\unlhd ° 


+H 


VVIO0 07377014 


\mp 

\div 
\setminus 
\cap 

\sqcap 

\wedge , \land 
\ominus 
\oslash 
\bigcirce 
\bigtriangledown 
\rhd * 

\unrhd 


*¥ * V A 


fe) 


~ror-o- F€ oO e 


\triangleleft 
\triangleright 
\star 

\ast 

\circ 

\bullet 
\diamond 
\uplus 

\amalg 
\dagger 
\ddagger 

\wr 
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AB 
AB 


AB 


Table 3.5: BIG Operators. 


Y> \sum U  \bigcup VV \bigvee 

I[ \prod () \bigcap /\\ \bigwedge 

[| \coprod || \bigsqcup J \biguplus 

if Naa f¢ \oint © \bigodot 

@ \bigoplus @® \bigotimes 

Table 3.6: Arrows. 
+ \leftarrow or \gets +— \longleftarrow 
— \rightarrow or \to —  \longrightarrow 
+ \leftrightarrow <— \longleftrightarrow 
< \Leftarrow <= \Longleftarrow 
= \Rightarrow => \Longrightarrow 
= \Leftrightarrow <=> \Longleftrightarrow 
+> \mapsto + \longmapsto 
<- \hookleftarrow > \hookrightarrow 
— \leftharpoonup — \rightharpoonup 
~— \leftharpoondown = \rightharpoondown 
= \rightleftharpoons <= >  \iff (bigger spaces) 
+ \uparrow L \downarrow 
¢  \updownarrow tt \Uparrow 
J) \Downarrow t \Updownarrow 
/ \nearrow NN, \searrow 
ZY \swarrow Ke \nwarrow 
~» \leadsto ° 
“Use the latexsym package to access this symbol 
Table 3.7: Arrows as Accents. 

\overrightarrow{AB} AB \underrightarrow{AB} 
\overleftarrow{AB} AB \underleftarrow{AB} 


\overleftrightarrow{AB} 


AB \underleftrightarrow{AB} 
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Table 3.8: Delimiters. 

















ee ) ) + \uparrow 

[ [or\lbrack |] ] or\rbrack | \downarrow 

{ \f{or\lbrace } \} or\rbrace { \updownarrow 

( \langle ) \rangle {+ \Uparrow 

| | or \vert | \| or Wert . \Downarrow 

ff. \ \backslash {} \Updownarrow 

| \lfloor | \rfloor 

| \rceil | \lceil 

Table 3.9: Large Delimiters. 
( \lgroup } \rgroup f \lmoustache 
| \arrowvert | \Arrowvert | \bracevert 
\rmoustache 
Table 3.10: Miscellaneous Symbols. 

wen Ndots ++»  \cdots : \vdots “ts. Addots 
h \hbar a \imath gj \jmath £  \ell 
R  \Re S \In XN  \aleph go \wp 
VY \forall 4 \exists O \mho * O \partial 
> / \prime ) \emptyset oo \infty 
V \nabla A \triangle \Box * © \Diamond ° 
| \bot T  \top Z  \angle /  \surd 
”®  \diamondsuit YQ \heartsuit @& \clubsuit @& \spadesuit 
—  \neg or \lnot b =6.\flat gh \natural ft \sharp 


“Use the latexsym package to access this symbol 


Table 3.11: Non-Mathematical Symbols. 


These symbols can also be used in text mode. 


t+ \dag § \S © \copyright (&) \textregistered 
t \ddag ( \P &£  \pounds % Nh 
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F \digamma 


r 


\ulcorner 
\lvert 


4 


Table 3.12: A,y4S Delimiters. 


\urcorner L 


| \rvert | 


\llcorner 1 \lrcorner 
\lVert | \rVert 


Table 3.13: A,4S Greek and Hebrew. 


x \varkappa 


3 \beth 


J \gimel ‘1 \daleth 


Table 3.14: Math Alphabets. 


See Table 6.4 on 109 for other math fonts. 












































Example Command Required package 
ABCDEabcdel234 \mathrm{ABCDE abcde 1234} 
ABCDEabcde1284  \mathit{ABCDE abcde 1234} 
ABCD Eabcde1234 \mathnormal{ABCDE abcde 1234} 
ABCDE \mathcal{ABCDE abcde 1234} 
A BEDE \mathscr{ABCDE abcde 1234} mathrsfs 
ABEDEabede1234 \mathfrak{ABCDE abcde 1234} amsfonts or amssymb 
ABCDEDFAKE \mathbb{ABCDE abcde 1234} amsfonts or amssymb 
Table 3.15: A,4S Binary Operators. 

+ \dotplus \centerdot 

x \ltimes x \rtimes * \divideontimes 

W \doublecup Mm \doublecap \ \smallsetminus 

Vv \veebar A  \barwedge A \doublebarwedge 

HH \boxplus A \boxminus © \circleddash 

X \boxtimes \boxdot © \circledcirce 

T \intercal @® \circledast <X \rightthreetimes 

Y \curlyvee A \curlywedge XX \leftthreetimes 
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Table 3.16: A\yS Binary Relations. 


\lessdot 
\leqslant 
\eqslantless 
\leqq 

\111 or \llless 
\lesssim 
\lessapprox 
\lessgtr 
\lesseqgtr 
\lesseqqgtr 
\preccurlyeq 
\curlyeqprec 
\precsim 
\precapprox 
\subseteqq 
\shortparallel 
\blacktriangleleft 
\vartriangleright 
\blacktriangleright 
\trianglerighteq 
\vartriangleleft 
\trianglelefteq 


LI YU NORY 2Y WV AIIVAIVAV 0YV 2V Vy IV WW VW 





Mm 


\gtrdot 
\geqslant 
\eqslantgtr 
\geqq 

\B& 
\gtrsim 
\gtrapprox 
\gtrless 
\gtreqless 
\gtreqqless 
\succcurlyeq 
\curlyeqsucc 
\succsim 
\succapprox 
\supseteqq 
\Supset 
\sqsupset 
\because 
\Subset 
\smallfrown 
\shortmid 
\therefore 








\doteqdot 
\risingdotseq 
\fallingdotseq 
\eqcirc 
\circeq 
\triangleq 
\bumpeq 
\Bumpeq 
\thicksim 
\thickapprox 
\approxeq 
\backsim 
\backsimeq 
\vDash 
\Vdash 
\Vvdash 
\backepsilon 
\varpropto 
\between 
\pitchfork 
\smallsmile 
\sqsubset 
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a 
| 
| 


$relos te limun 


Table 3.17: A,4S Arrows. 


\dashleftarrow 
\leftleftarrows 
\leftrightarrows 
\Lleftarrow 
\twoheadleftarrow 
\leftarrowtail 
\leftrightharpoons 
\Lsh 
\looparrowleft 
\curvearrowleft 
\circlearrowleft 
\multimap 
\downdownarrows 
\upharpoonright 
\rightsquigarrow 


| 
| 
v 


Leundu 





F-—--3Cc 0 f +1 


\dashrightarrow 
\rightrightarrows 
\rightleftarrows 
\Rrightarrow 
\twoheadrightarrow 
\rightarrowtail 
\rightleftharpoons 
\Rsh 
\looparrowright 
\curvearrowright 
\circlearrowright 
\upuparrows 
\upharpoonleft 
\downharpoonright 


\leftrightsquigarrow 
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Table 3.18: A,4S Negated Binary Relations and Arrows. 


\nless 

\lneq 

\nleq 
\nleqslant 
\lneqq 
\lvertneqq 
\nleqq 
\lnsim 
\lnapprox 
\nprec 
\npreceq 
\precneqq 
\precnsim 
\precnapprox 
\subsetneq 
\varsubsetneq 
\nsubseteq 
\subsetneqq 


\nleftarrow 
\nLeftarrow 


Table 3.19: A,4S Miscellaneous. 


\hbar 

\square 
\vartriangle 
\triangledown 
\lozenge 
\angle 
\diagup 
\nexists 

\eth 


MG 





tb of HUTT 1 RY RY HY RE SRV ADV TMV AV WK HEV 


h 


A 
v 
4 
& 

2s 
a 
< 


\ngtr 

\gneq 

\ngeq 
\ngeqslant 
\gneqq 
\gvertneqq 
\ngeqq 
\gnsim 
\gnapprox 
\nsucc 
\nsucceq 
\succneqq 
\succnsim 
\succnapprox 
\supsetnegq 
\varsupsetneq 
\nsupseteq 
\supsetneqq 


\nrightarrow 
\nRightarrow 


\hslash 
\blacksquare 


\blacktriangle 


da 





$§ f MPA BRAK R ERR Ss ~*~ eS WAH 


\blacktriangledown 


\blacklozenge 


\measuredangle 


\diagdown 
\Finv 


\sphericalangle 


\varsubsetneqq 
\varsupsetneqq 
\nsubseteqq 
\nsupseteqq 
\nmid 

\nparallel 
\nshortmid 
\nshortparallel 
\nsim 

\ncong 

\nvdash 

\nvDash 

\nVdash 

\nVDash 
\ntriangleleft 
\ntriangleright 
\ntriangleleftegq 
\ntrianglerighteg 
\nleftrightarrow 
\nLeftrightarrow 


\Bbbk 
\circleds 
\complement 
\Game 


OU 2@ F 


\bigstar 


\ \backprime 
@ \varnothing 
O \mho 


Chapter 4 
Specialities 


When putting together a large document, ATEX will help with some special 
features like index generation, bibliography management, and other things. A 
much more complete description of specialities and enhancements possible with 
ATEX can be found in the ATRX Manual [1| and The ATRX Companion [3]. 


4.1 Bibliography 


Produce a bibliography with the thebibliography environment. Each entry 
starts with 











\bibitem [label] {marker} 





The marker is then used to cite the book, article or paper within the 
document. 











\cite{tmarker} 





If you do not use the label option, the entries will get enumerated auto- 
matically. The parameter after the \begin{thebibliography} command 
defines how much space to reserve for the number of labels. In the exam- 
ple below, {99} tells ATRX to expect that none of the bibliography item 
numbers will be wider than the number 99. 
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Partl~\cite{pa} has 

proposed that \ldots 
\begin{thebibliography}{99} 
\bibitem{pa} H.~Partl: 
\emph{German \TeX}, 

TUGboat Volume~9, Issue~1 (1988) 
\end{thebibliography} 








Partl [1] has proposed that ... 


Bibliography 


[1] H. Parth German Tgx, TUGboat 
Volume 9, Issue 1 (1988) 








For larger projects, you might want to check out the BibTpX program. 


BibTExX is included with most TeX distributions. It allows you to main- 
tain a bibliographic database and then extract the references relevant to 
things you cited in your paper. The visual presentation of BibTRX-generated 
bibliographies is based on a style-sheets concept that allows you to create 
bibliographies following a wide range of established designs. 


4.2 Indexing 


A very useful feature of many books is their index. With I4TRxX and the 
support program makeindex,! an index can be generated quite easily. This 
introduction will only explain the basic index generation commands. For a 
more in-depth view, please refer to The ATEX Companion [3]. 

To enable their indexing feature of ATEX, the makeidx package must be 
loaded in the preamble with 











\usepackage{makeidx} 





and the special indexing commands must be enabled by putting the 





\makeindex 











command in the preamble. 





‘On systems not necessarily supporting filenames longer than 8 characters, the program 
may be called makeidx. 


4.2 Indexing 





Table 4.1: Index Key Syntax Examples. 





Example Index Entry Comment 
\index{fhello} hello, 1 Plain entry 
\indexfhello! Peter} Peter, 3 Subentry under ‘hello’ 
\index{Sam@\texts1{Sam}} Sam, 2 Formatted entry 
\index{Lin@\textbf{Lin}} Lin, 7 Formatted entry 
\index{Kaese@\textbf{K\"ase}} Kase, 33 Formatted entry 
\indexfecole@\'ecole} école, 4 Formatted entry 
\index{Jenny | textbf} Jenny, 3 Formatted page number 
\index{Joe|textit} Joe, 5 Formatted page number 


The content of the index is specified with 








\index{key@formatted_ entry} 








commands, where formatted_ entry will appear in the index and key will be 
used for sorting. The formatted_ entry is optional. If it is missing the key 
will be used. You enter the index commands at the points in the text that 
you want the final index entries to point to. Table 4.1 explains the syntax 
with several examples. 

When the input file is processed with FTX, each \index command 
writes an appropriate index entry, together with the current page number, 
to a special file. The file has the same name as the IATRX input file, but a 
different extension (.idx). This .idx file can then be processed with the 
makeindex program: 











makeindex filename 





The makeindex program generates a sorted index with the same base 
file name, but this time with the extension .ind. If now the ATRX input file 
is processed again, this sorted index gets included into the document at the 
point where Trex finds 











\printindex 





The showidx package that comes with ATpX 2¢ prints out all index en- 
tries in the left margin of the text. This is quite useful for proofreading a 
document and verifying the index. 

Note that the \index command can affect your layout if not used care- 
fully. 


76 


Specialities 





My Word \index{Word}. As opposed 
to Word\index{Word}. Note the 
position of the full stop. 








My Word . As opposed to Word. Note 
the position of the full stop. 





makeindex has no clue about characters outside the ASCII range. To 
get the sorting correct, use the @ character as shown in the Kase and école 


examples above 


4.3 Fancy Headers 


The fancyhdr package,” written by Piet van Oostrum, provides a few simple 
commands that allow you to customize the header and footer lines of your 
document. Look at the top of this page, for an application of this package. 





\documentclass{book} 
\usepackage{fancyhdr} 
\pagestyle{fancy} 


% with this we ensure that the chapter and section 


% headings are in lowercase. 


\renewcommand{\chaptermark}[1]{% 


\markboth{#1}{}} 


\renewcommand{\sectionmark} [1] {% 
\markright{\thesection\ #1}} 
\fancyhf{} % delete current header and footer 
\fancyhead [LE, RO] {\bfseries\thepage} 
\fancyhead [LO] {\bfseries\rightmark} 
\fancyhead [RE] {\bfseries\leftmark} 
\renewcommand{\headrulewidth}{0.5pt} 
\renewcommand{\footrulewidth}{Opt} 
\addtolength{\headheight}{0.5pt} % space for the rule 


\fancypagestyle{plain}{% 


\fancyhead{} % get rid of headers on plain pages 
\renewcommand{\headrulewidth}{Opt} % and the line 





Figure 4.1: Example fancyhdr Setup. 


The tricky problem when customising headers and footers is to get things 
like running section and chapter names in there. XIX accomplishes this 
with a two-stage approach. In the header and footer definition, you use 
the commands \rightmark and \leftmark to represent the current section 





? Available from CTAN: //macros/latex/contrib/supported/fancyhdr. 


4.4 The Verbatim Package 
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and chapter heading, respectively. The values of these two commands are 
overwritten whenever a chapter or section command is processed. 

For ultimate flexibility, the \chapter command and its friends do not 
redefine \rightmark and \leftmark themselves. They call yet another com- 
mand (\chaptermark, \sectionmark, or \subsectionmark) that is respon- 
sible for redefining \rightmark and \leftmark. 

If you want to change the look of the chapter name in the header line, 
you need only “renew” the \chaptermark command. 

Figure 4.1 shows a possible setup for the fancyhdr package that makes the 
headers look about the same as they look in this booklet. In any case, I sug- 
gest you fetch the documentation for the package at the address mentioned 
in the footnote. 


4.4 The Verbatim Package 


Earlier in this book, you got to know the verbatim environment. In this 
section, you are going to learn about the verbatim package. The verbatim 
package is basically a re-implementation of the verbatim environment that 
works around some of the limitations of the original verbatim environment. 
This by itself is not spectacular, but the implementation of the verbatim 
package added new functionality, which is why I am mentioning the package 
here. The verbatim package provides the 











\verbatiminput {filename} 





command, which allows you to include raw ASCII text into your document 
as if it were inside a verbatim environment. 

As the verbatim package is part of the ‘tools’ bundle, you should find it 
pre-installed on most systems. If you want to know more about this package, 
make sure to read [10]. 


4.5 Installing Extra Packages 


Most IATFX installations come with a large set of pre-installed style packages, 
but many more are available on the net. The main place to look for style 
packages on the Internet is CTAN (http: //www.ctan.org/). 

Packages such as geometry, hyphenat, and many others are typically made 
up of two files: a file with the extension .ins and another with the extension 
.dtx. There will often be a readme.txt with a brief description of the 
package. You should of course read this file first. 

In any event, once you have copied the package files onto your machine, 
you still have to process them in a way that (a) tells your TrX distribution 
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about the new style package and (b) gives you the documentation. Here’s 
how you do the first part: 


1. Run TeX on the .ins file. This will extract a .sty file. 


2. Move the .sty file to a place where your distribution can find it. Usu- 
ally this is in your ../localtexmf/tex/latex subdirectory (Windows 
or OS/2 users should feel free to change the direction of the slashes). 


3. Refresh your distribution’s filename database. The command de- 
pends on the 4TpXdistribution you use: TRXlive — texhash; web2c 
—maktexlsr; MikTpX — initexmf --update-fndb or use the GUI. 


Now extract the documentation from the .dtx file: 


1. Run Xq4TRX on the .dtx file. This will generate a .pdf file. Note 
that you may have to run XqIATRX several times before it gets the 
cross-references right. 


2. Check to see if 41x has produced a .idx file among the various files 
you now have. If you do not see this file, then the documentation has 
no index. Continue with step 5. 


3. In order to generate the index, type the following: 
makeindex -s gind.ist name 














(where name stands for the main-file name without any extension). 
4. Run IATRX on the .dtx file once again. 


5. Last but not least, make a .ps or .pdf file to increase your reading 
pleasure. 


Sometimes you will see that a .glo (glossary) file has been produced. 
Run the following command between step 4 and 5: 
makeindex -s gglo.ist -o name.gls name.glo 
Be sure to run I4TRX on the .dtx one last time before moving on to step 5. 


4.6 TeX and PDF 


By Daniel Flipo <Daniel.Flipo@univ-lille1.fr> 


PDF is a portable hypertext document format. Much as in a web page, 
some words in the document are marked as hyperlinks. They link to other 
places in the document or even to other documents. If you click on such a 
hyperlink you get transported to the destination of the link. In the context 
of IATRX, this means that all occurrences of \ref and \pageref become 
hyperlinks. Additionally, the table of contents, the index and all the other 
similar structures become collections of hyperlinks. 


4.6 IATpRX and PDF 
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Most web pages you find today are written in HTML (HyperText Markup 
Language). This format has two significant disadvantages when writing 
scientific documents: 


1. Including mathematical formulae into HTML documents is not gener- 
ally supported. While there is a standard for it, most browsers used 
today do not support it, or lack the required fonts. 


2. Printing HTML documents is possible, but the results vary widely 
between platforms and browsers. The results are miles removed from 
the quality we have come to expect in the ATRX world. 


There have been many attempts to create translators from ITRX to 
HTML. Some were even quite successful in the sense that they are able 
to produce legible web pages from a standard I4TfX input file. But all of 
them cut corners left and right to get the job done. As soon as you start 
using more complex JATRX features and external packages things tend to 
fall apart. Authors wishing to preserve the unique typographic quality of 
their documents even when publishing on the web turn to PDF (Portable 
Document Format), which preserves the layout of the document and permits 
hypertext navigation. Most modern browsers come with plugins that allow 
the direct display of PDF documents. 

All modern TFrX engines can generate PDF files out of the box. If you 
worked through this introduction until here you will already be familiar with 
the process. 


4.6.1 Hypertext Links 
The hyperref adds two cool features to your ATpX PDF files: 


1. The paper size is set according to your specification in the document 
class call. 


2. All references in your your document turn into hyperlinks. 


Just add \usepackage{hyperref} as the last command into the pream- 
ble of your document. 

Many options are available to customize the behaviour of the hyperref 
package: 


e either as a comma separated list after the pdftex option 
\usepackagethyperref } 


e or on individual lines with the command \hypersetup{ options}. 


In the following list the default values are written in an upright font. 
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bookmarks (=true, false) show or hide the bookmarks bar when 
displaying the document 


unicode (=false, true) allows the use of characters of non-Latin based 
languages in Acrobat’s bookmarks 


pdftoolbar (=true, false) show or hide Acrobat’s toolbar 
pdfmenubar (=true, false) show or hide Acrobat’s menu 


pdffitwindow (=false, true) adjust the initial magnification of the PDF 
when displayed 


pdftitle (={text}) define the title that gets displayed in the Document 
Info window of Acrobat 


pdfauthor (={text}) the name of the PDF’s author 


pdfnewwindow (=false, true) define whether a new window should be 
opened when a link leads out of the current document 


colorlinks (=false,true) surround the links by colour frames (false) 
or colour the text of the links (true). The colour of these links can 
be configured using the following options (default colours are shown): 


linkcolor (=red) colour of internal links (sections, pages, etc.) 
citecolor (=green) colour of citation links (bibliography) 
filecolor (=magenta) colour of file links 
urlcolor (=cyan) colour of URL links (mail, web) 

If you are happy with the defaults, use 


\usepackage{hyperref} 


To have the bookmark list open and links in colour (the =true values 
are optional): 


\usepackage [bookmarks , colorlinks] {hyperref} 


When creating PDFs destined for printing, coloured links are not a good 
thing as they end up in gray in the final output, making it difficult to read. 
Use colour frames, which are not printed: 


\usepackage{hyperref} 
\hypersetup{colorlinks=false} 


or make links black: 
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\usepackagethyperref } 

\hypersetup{colorlinks,% 
citecolor=black, % 
filecolor=black,% 
linkcolor=black, % 
urlcolor=black,% 
pdftex} 


When you just want to provide information for the Document Info sec- 
tion of the PDF file: 


\usepackage [pdfauthor={Pierre Desproges},% 
pdftitle={Des femmes qui tombent},% 
pdftex] {hyperref} 


In addition to the automatic hyperlinks for cross references, it is possible 
to embed explicit links using 





\href{url}{text} 











The code 
The \href{http://www.ctan.org}{CTAN} website. 


produces the output “CTAN”; a click on the word “CTAN” will take you to 
the CTAN website. 

If the destination of the link is not a URL but a local file, use the \href 
command without the ’http://’ bit: 


The complete document is \href{manual.pdf}{here} 


which produces the text “The complete document is here”. A click on the 
word “here” will open the file manual.pdf. (The filename is relative to the 
location of the current document). 

The author of an article might want her readers to easily send email 
messages by using the \hnref command inside the \author command on the 
title page of the document: 


\author{Mary Oetiker $<$\href{mailto:mary@oetiker.ch}% 
{mary@oetiker.ch}$>$ 


Note that I have put the link so that my email address appears not only in 
the link but also on the page itself. I did this because the link 
\href{mailto:mary@oetiker.ch}{Mary Oetiker} 

would work well within Acrobat, but once the page is printed the email 
address would not be visible anymore. 
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4.6.2 Problems with Links 


Messages like the following: 


! pdfTeX warning (ext4): destination with the same 
identifier (name{page.1}) has been already used, 
duplicate ignored 


appear when a counter gets reinitialized, for example by using the command 
\mainmatter provided by the book document class. It resets the page num- 
ber counter to 1 prior to the first chapter of the book. But as the preface of 
the book also has a page number 1 all links to “page 1” would not be unique 
anymore, hence the notice that “duplicate has been ignored.” 

The counter measure consists of putting plainpages=false into the 
hyperref options. This unfortunately only helps with the page counter. An 
even more radical solution is to use the option 
hypertexnames=false, but this will cause the page links in the index to 
stop working. 


4.6.3 Problems with Bookmarks 


The text displayed by bookmarks does not always look like you expect it to 
look. Because bookmarks are “just text,” fewer characters are available for 
bookmarks than for normal IATRX text. Hyperref will normally notice such 
problems and put up a warning: 


Package hyperref Warning: 
Token not allowed in a PDFDocEncoded string: 


Work around this problem by providing a text string for the bookmarks, 
which replaces the offending text: 











\texorpdfstring{TpX tert}{ Bookmark Text} 





Math expressions are a prime candidate for this kind of problem: 


\section{\texorpdfstring{$E=mc*2$}% 
{E = mc ** 2}} 


which turns \section{$E=mc~2$} to “E = mc ** 2” in the bookmark area. 

If you write your document in Unicode and use the unicode option for 
the hyperref package to use Unicode characters in bookmarks, this will give 
you a much larger selection of characters to pick from when when using 
\texorpdfstring. 
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4.7 Working with Xq/4TpxX and PDF 


By Axel Kielhorn <A.Kielhorn@web.de> 


Most of the things said in the previous section are valid for XqI4TRX as well. 
There is a Wiki at http: //wiki.xelatex.org/doku. php that collects 
information relevant to XqIfRX and XqlATRX. 


4.7.1 The Fonts 


In addition to the normal tfm based fonts, XqJ4TpX is able to use any font 
known to the operating system. If you have the Linux Libertine fonts 
installed, you can simply say 


\usepackage{fontspec} 
\setmainfont [Ligatures=TeX]{Linux Libertine} 


in the preamble. This will normally detect the italic and bold versions 
as well, so \textit and \textbf will work as usual. When the font is 
using OpenType technology you have access to many features which required 
switching to a separate font or using virtual fonts in the past. The main 
feature is the extended character set; a font may contain Latin, Greek and 
Cyrillic characters and the corresponding ligatures. 

Many fonts contain at least two kinds of numerals, the normal lining 
numerals and so called old style (or lower case) numerals, which partly 
extend below the baseline. They may contain proportional numerals (the 
“1” takes less space than the “0”) or monospaced numerals which are suitable 
for tables. 


\newf ontfamily\LL1n [Numbers=Lining] { (font) } 

\newf ontfamily\LLos [Numbers=01dStyle] { (font) } 

\newf ontfamily\LL1nm [Numbers=Lining , Numbers=Monospaced] { (font) } 
\newf ontfamily\LLosm [Numbers=01dStyle, Numbers=Monospaced] { (font) } 


Almost all OpenType fonts contain the standard ligatures (fl fi fi) but 
there are also some rare or historical ligatures like st, ct and tz. You may 
not want to use them in a technical report but they are fine for a novel. To 
enable these ligatures use either of the following lines: 


\setmainfont [Ligatures=Rare] { (font) } 
\setmainfont [Ligatures=Historic] { (font) } 
\setmainfont [Ligatures=Historic, Ligatures=Rare] { (font) } 


Not every font contains both sets of ligature, consult the font documen- 
tation or just try it out. Sometimes these ligatures are language dependent; 
for example a ligature used in Polish (fk) is not used in English. You have 
to add 
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\setmainfont [Language=Polish] { (font) } 


to enable the Polish ligatures. 

Some fonts (like the commercial Adobe Garamond Premier Pro) contain 
alternative glyphs that are activated by default in XqI4TpX distributed with 
TrXLive 2010°. The result is a stylish “Q” with a descender reaching below 
the following “u”. To disable this feature you have to define the font with 
disabled contextuals: 


\setmainfont [Contextuals=NoAlternate] { (font) } 


To learn about fonts in XqIATRX read the fontspec manual. 


Where do I get OpenType fonts? 


If you have TeXLive installed, you already have some at .../texmf-dist/ 
fonts/opentype, just install them in your operating system. This collection 
does not include DejaVu, which is available at http: //dejavu-fonts.org/. 

Make sure that each font is only installed once, otherwise interesting 
results may happen. 

You can use every font installed on your computer, but remember that 
other users may not have these fonts. The Zapfino font used in the fontspec 
manual is included in Mac OSX, but is not available on Windows comput- 
ers.* 


Entering Unicode Characters 


The number of characters in a font has grown but the number of keys on a 
regular keyboard has not. So, how do I enter non-ASCII characters? 

If you write a large amount of text in a foreign language, you can in- 
stall a keyboard for that language and print out the character positions. 
(Most operatings system have some sort of virtual keyboard, just make a 
screenshot. ) 

If you rarely need an exotic character, you can simply pick it in the 
character palette. 

Some environments (e. g. the X Window System) offer many methods to 
enter non-ASCII characters. Some editors (e.g. Vim and Emacs) offer ways 
to enter these characters. Read the manual for the tools you are using. 


4.7.2 Compatibility Between Xql4TRX and pdfETRX 
There are a few things that are different between XqI4TRX and pdflATRX. 





’The behavior has changed with this version, it was off by default in earlier releases. 
*A commercial version of the font called Zapfino Extra is available. 
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e A Xql4TeX document has to be written in Unicode (UTF-8) while 
pdflATexX may use different input encodings. 


e The microtype packages does not work with Xq/4TpX yet, support for 
character protrusion is already under development. 


e Everything font related has to be reviewed. (Unless you want to stick 
to Latin Modern.) 


4.8 Creating Presentations 


By Daniel Flipo <Daniel.Flipo@univ-lille1.fr> 


You can present the results of your scientific work on a blackboard, with 
transparencies, or directly from your laptop using some presentation soft- 
ware. 

pdf4Tex combined with the beamer class allows you to create presenta- 
tions in PDF, looking much like something you might be able to generate 
with LibreOffice or PowerPoint if you had a very good day, but much more 
portable because PDF readers are available on many more systems. 

The beamer class uses graphicx, color and hyperref with options adapted 
to screen presentations. 

When you compile the code presented in figure 4.2 with pdf4TRX you 
get a PDF file with a title page and a second page showing several items 
that will be revealed one at a time as you step though your presentation. 

One of the advantages of the beamer class is that it produces a PDF 
file that is directly usable without first going through a POSTSCRIPT stage 
like prosper or requiring additional post processing like presentations created 
with the ppower4 package. 

With the beamer class you can produce several versions (modes) of your 
document from the same input file. The input file may contain special 
instructions for the different modes in angular brackets. The following modes 
are available: 


beamer for the presentation PDF discussed above. 
trans for transparencies. 
handout for the printed version. 


The default mode is beamer, change it by setting a different mode as a 
global option, like \documentclass[10pt ,handout]{beamer} to print the 
handouts for example. 

The look of the screen presentation depends on the theme you choose. 
Pick one of the themes shipped with the beamer class or create your own. 
See the beamer class documentation in beameruserguide.pdf for more in- 
formation on this. 
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\documentclass [10pt] {beamer} 
\mode<beamer>{¥, 
\usetheme [hideothersubsections, 
right ,width=22mm] {Goettingen} 


\title{Simple Presentation} 

\author[D. Flipo] {Daniel Flipo} 
\institute{U.S.T.L. \& GUTenberg} 
\titlegraphic{\includegraphics [width=20mm] {USTL}} 
\date{2005} 


\begin{document} 


\begin{frame}<handout : 0> 
\titlepage 
\end{frame} 


\section{An Example} 


\begin{frame} 
\frametitle{Things to do on a Sunday Afternoon} 
\begin{block}{One could \ldots} 
\begin{itemize} 
\item walk the dog\dots \pause 
\item read a book\pause 
\item confuse a cat\pause 
\end{itemize} 
\end{block} 
and many other things 
\end{frame} 
\end{document} 


Figure 4.2: Sample code for the beamer class 
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Let’s have a closer look at the code in figure 4.2. 

For the screen version of the presentation \mode<beamer> we have chosen 
the Goettingen theme to show a navigation panel integrated into the table 
of contents. The options allow us to choose the size of the panel (22 mm in 
this case) and its position (on the right side of the body text). The option 
hideothersubsections, shows the chapter titles, but only the subsections of 
the present chapter. There are no special settings for \mode<trans> and 
\mode<handout>. They appear in their standard layout. 

The commands \title{}, \author{}, \institute{}, and 
\titlegraphic{} set the content of the title page. The optional arguments 
of \title[]{} and \author [] {} let you specify a special version of the title 
and the author name to be displayed on the panel of the Goettingen theme. 

The titles and subtitles in the panel are created with normal \section{} 
and \subsection{} commands that you place outside the frame environ- 
ment. 

The tiny navigation icons at the bottom of the screen also allow to nav- 
igate the document. Their presence is not dependent on the theme you 
choose. 

The contents of each slide or screen has to be placed inside a frame 
environment. There is an optional argument in angular brackets (< and 
>), it allows us to suppress a particular frame in one of the versions of 
the presentation. In the example the first page would not be shown in the 
handout version due to the <handout:0> argument. 

It is highly recommended to set a title for each slide apart from the 
title slide. This is done with the command \frametitle{}. If a subtitle is 
necessary use the block environment as shown in the example. Note that 
the sectioning commands \section{} and \subsection{} do not produce 
output on the slide proper. 

The command \pause in the itemize environment lets you reveal the 
items one by one. For other presentation effects check out the commands 
\only, \uncover, \alt and \temporal. In many place it is possible to use 
angular brackets to further customize the presentation. 

In any case make sure to read through the beamer class documentation 
beameruserguide.pdf to get a complete picture of what is in store for you. 
This package is being actively developed, check out their website to get the 
latest information. (http://latex-beamer.sourceforge.net /) 


Chapter 5 


Producing Mathematical 
Graphics 


Most people use ATEX for typesetting their text. And since the structure ori- 
ented approach to authoring is so convenient, IATEX also offers a, if somewhat 
restricted, means for producing graphical output from textual descriptions. Fur- 
thermore, quite a number of IATEX extensions have been created in order to 
overcome these restrictions. In this section, you will learn about a few of them. 


5.1 Overview 


Creating graphical output with F!ATpX has a long tradition. It started out 
with the picture environment which allows you to create graphics by clev- 
erly placing predefined elements onto the canvas. A complete description 
can be found in the ATfX Manual |||. The picture environment of ATRX 2¢ 
brings with it the \qbezier command, “q” meaning “quadratic”. Many fre- 
quently used curves such as circles, ellipses, or catenaries can be satisfactorily 
approximated by quadratic Bézier curves, although this may require some 
mathematical toil. If, in addition, a programming language is used to gener- 
ate \qbezier blocks of IATRX input files, the picture environment becomes 
quite powerful. 

Although programming pictures directly in IATRX is severely restricted, 
and often rather tiresome, there are still reasons for doing so. The documents 
thus produced are “small” with respect to bytes, and there are no additional 
graphics files to be dragged along. 

This has been the state of things until a few years ago when Till Tantau 
of beamer fame came up with the Portable Graphics Format pgf and its 
companion package TikZ (tikz). This system lets you create high quality 
vector graphics with all current TREX systems including full support for pdf. 
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Building on these basics, numerous packages have been written for spe- 
cific purposes. A wide variety of these packages is described in detail in The 
TEX Graphics Companion [4]. 

Perhaps the most advanced graphical tool related with ATfX is META- 
POST. It is a stand-alone application based on Donald E. Knuth’s META- 
FONT. METAPOST has the very powerful and mathematically sophisti- 
cated programming language of METAFONT but contrary to METAFONT, it 
generates encapsulated POSTSCRIPT files, which can be imported in TRxX 
and even pdffATp@X. For an introduction, see A User’s Manual for META- 
POST [14], or the tutorial on [16]. 

A very thorough discussion of ATRX and TX strategies for graphics (and 
fonts) can be found in TRX Unbound [15]. 


5.2 The picture Environment 


By Urs Oswald <osurs@bluewin.ch> 


As mentioned above the picture environment is part of standard ATRxX 
and it is great for simple tasks and also if you want to control the exact 
positioning of individual elements on a page. But if you are about to do any 
serious graphics work, you should look at TikZ as presented in section 5.3 
on page 99. 


5.2.1 Basic Commands 


A picture environment! is created with one of the two commands 











\begin{picture} (a, y)...\end{picture} 





or 











\begin{picture} (x, y) (xo, yo)...\end{picture} 





The numbers 2, y, Xo, yo refer to \unitlength, which can be reset any 
time (but not within a picture environment) with a command such as 











\setlength{\unitlength}{1.2cm} 





The default value of \unitlength is 1pt. The first pair, (x, y), effects the 
reservation, within the document, of rectangular space for the picture. The 
optional second pair, (29, yo), assigns arbitrary coordinates to the bottom 
left corner of the reserved rectangle. 





‘Believe it or not, the picture environment works out of the box, with standard IATRX 2¢ 
no package loading necessary. 
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Most drawing commands have one of the two forms 











\put (x, y) {object} 





or 








\multiput (x, y) (Az, Ay) {n} {object} 








Bézier curves are an exception. They are drawn with the command 











\qbezier (21, y1) (Xa, y2) (x3, y3) 





5.2.2 Line Segments 


\setlength{\unitlength}{5cm} 
\beginfpicture} (1,1) 
\put (0,0) {\line(0,1){1}} 
\put (0,0) {\line(1,0){1}} 
\put (0,0) {\line(1,1){1}} 
\put (0,0) {\line(1,2){.5}} 
\put (0,0) {\line(1,3) {.3333}} 





\put (0,0) {\line(1,4){.25}} 
\put (0,0) {\line(1,5){.2}} 
\put (0,0) {\line(1,6){.1667}} 
\put (0,0) {\line(2,1){1}} 
\put (0,0) {\line(2,3){.6667}} 
\put (0,0) {\line(2,5){.4}} 
\put (0,0) {\line(3, 1) {1}} 
\put (0,0) {\line(3,2){1}} 
\put (0,0) {\line(3,4){.75}} 
\put (0,0) {\line(3,5){.6}} 
\put (0,0) {\line(4, 1) {1}} 
\put (0,0) {\line(4,3) {1}} 
\put (0,0) {\line(4,5){.8}} 

















\put (0,0) {\line(5,1){1}} 
\put (0,0) {\line(5,2){1}} 
\put (0,0) {\line(5,3){1}} 
\put (0,0) {\line(5,4){1}} 
\put (0,0) {\line(5,6){.8333}} 
\put (0,0) {\line(6,1){1}} 
\put (0,0) {\line(6,5) {1}} 
\end{picture} 
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Line segments are drawn with the command 





\put (a, y) {\line (x1, y,) {length}} 











The \line command has two arguments: 
1. a direction vector, 
2. a length. 
The components of the direction vector are restricted to the integers 
—6, —5,..., 5, 6, 


and they have to be coprime (no common divisor except 1). The figure 
illustrates all 25 possible slope values in the first quadrant. The length is 
relative to \unitlength. The length argument is the vertical coordinate 
in the case of a vertical line segment, the horizontal coordinate in all other 
cases. 


5.2.3 Arrows 


\setlength{\unitlength}{0.75mm} 
\begin{picture} (60,40) 
\put (30, 20) {\vector (1,0) {30}} 
\put (30, 20) {\vector (4,1) {20}} 
\put (30,20) {\vector (3,1) {25}} 
\put (30, 20) {\vector (2, 1){30}} 
\put (30,20) {\vector(1,2){10}} 
\thicklines 
\put (30,20) {\vector (-4, 1) {30}} 
\put (30, 20) {\vector (-1,4) {5}} 
\thinlines 
\put (30, 20) {\vector(-1,-1){5}} 
\put (30, 20) {\vector(-1,-4){5}} 
\end{picture} 














Arrows are drawn with the command 











\put (a2, y) {\vector (21, y1) {length}} 





For arrows, the components of the direction vector are even more nar- 
rowly restricted than for line segments, namely to the integers 


a ee ee: te 


Components also have to be coprime (no common divisor except 1). Notice 
the effect of the \thicklines command on the two arrows pointing to the 
upper left. 
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5.2.4 Circles 


\setlength{\unitlength}{1mm} 

\beginfpicture}(60, 40) 
\put (20,30) {\circle{1}} 
\put (20,30) {\circle{2}} 
\put (20,30) {\circle{4}} 
\put (20,30) {\circle{8}} 
\put (20,30) {\circle{16}} 
\put (20,30) {\circle{32}} 





\put (40,30) {\circle{1}} 
\put (40,30) {\circle{2}} 
\put (40,30) {\circle{3}} 
\put (40,30) {\circle{4}} 
\put (40,30) {\circle{5}} 
\put (40,30) {\circle{6}} 
\put (40,30) {\circle{7}} 
\put (40,30) {\circle{8}} 
\put (40,30) {\circle{9}} 
\put (40,30) {\circle{10}} 
\put (40,30) {\circle{11}} 














\put (40,30) {\circle{12}} 
\put (40,30) {\circle{13}} 
\put (40,30) {\circle{14}} 


\put (15,10) {\circle*{1}} 
\put (20,10) {\circle*{2}} 
\put (25, 10) {\circle*{3}} 
\put (30, 10) {\circle*{4}} 
\put (35, 10) {\circle*{5}} 
\end{picture} 





The command 





\put (xz, y) {\circle{diameter}} 











draws a circle with center (x,y) and diameter (not radius) diameter. The 
picture environment only admits diameters up to approximately 14mm, 
and even below this limit, not all diameters are possible. The \circle* 
command produces disks (filled circles). 

As in the case of line segments, one may have to resort to additional 
packages, such as eepic or pstricks. For a thorough description of these 
packages, see The ATRX Graphics Companion [4]. 

There is also a possibility within the picture environment. If one is not 
afraid of doing the necessary calculations (or leaving them to a program), 
arbitrary circles and ellipses can be patched together from quadratic Bézier 
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curves. See Graphics in ATpX 2¢ [16] for examples and Java source files. 


5.2.5 Text and Formulas 


\setlength{\unitlength}{0.8cm} 
\begin{picture} (6,5) 
\thicklines 
\put (1,0.5){\line(2,1){3}} 
\put (4,2) {\line(-2,1){2}} 
\put (2,3) {\line(-2, -5){1}} F = y/s(s — a)(s — b)(s —¢) 
\put (0.7,0.3){$A$} 
\put (4.05,1.9){$B$} 
\put (1.7,2.95){$C$} 
\put (3.1,2.5){$a$} 
\put (1.3,1.7){$b$} 
\put (2.5,1.05) {$c$} 
\put (0.3,4) {$F= 
\sqrt{s (s-a) (s-b) (s-c) }$} 
\put (3.5,0.4) {$\displaystyle 
s:=\fractatbtc}{2}$} 
\end{picture} 




















As this example shows, text and formulas can be written into a picture 
environment with the \put command in the usual way. 


5.2.6 \multiput and \linethickness 


\setlength{\unitlength}{2mm} 
\begin{fpicture} (30,20) 
\linethickness{0.075mm} 
\multiput (0,0) (1,0) {26}% 
{\line (0,1) {20}} 
\multiput (0,0) (0,1) {21}% 
{\line (1,0) {25}} 
\linethickness{0. 15mm} 
\multiput (0,0) (5,0) {6}% 
{\line (0,1) {20}} 
\multiput (0,0) (0,5) {5}% 
{\line (1,0) {25}} 
\linethickness{0. 3mm} 
\multiput (5,0) (10,0) {2}% 
{\line (0,1) {20}} 
\multiput (0,5) (0,10) {2}% 
{\line (1,0) {25}} 
\end{picture} 
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The command 





\multiput (x, y) (Az, Ay) {n} {object} 











has 4 arguments: the starting point, the translation vector from one ob- 
ject to the next, the number of objects, and the object to be drawn. The 
\linethickness command applies to horizontal and vertical line segments, 
but neither to oblique line segments, nor to circles. It does, however, apply 
to quadratic Bézier curves! 


5.2.7 Ovals 


\setlength{\unitlength}{0.75cm} 
\begin{picture} (6,4) 
\linethickness{0.075mm} 
\multiput (0,0) (1,0) {7}% 
{\line(0,1){4}} 
\multiput (0,0) (0,1) {5}% 
{\line(1,0){6}} 
\thicklines 


\put (2,3) {\oval(3,1.8)} 
\thinlines / . = 


\put (3,2) {\oval(3,1.8)} 

\thicklines \ J 

\put (2,1) {\oval(3,1.8) [t1]} 

\put (4,1) {\oval(3,1.8) [b] } 

\put (4,3) {\oval(3,1.8) [r]} 

\put (3,1.5) {\oval(1.8,0.4)} 
\end{picture} 





















































The command 





\put (x, y) {\oval (w, h)} 











or 





\put (x, y) {\oval (w, h) [position] } 











produces an oval centered at (x,y) and having width w and height h. The 
optional position arguments b, t, 1, r refer to “top”, “bottom”, “left”, “right”, 
and can be combined, as the example illustrates. 

Line thickness can be controlled by two kinds of commands: 
\linethickness{length} on the one hand, \thinlines and \thicklines 
on the other. While \lLinethickness{length} applies only to horizontal and 
vertical lines (and quadratic Bézier curves), \thinlines and \thicklines 
apply to oblique line segments as well as to circles and ovals. 


96 Producing Mathematical Graphics 





5.2.8 Multiple Use of Predefined Picture Boxes 


\setlength{\unitlength}{0.5mm} 
\beginfpicture} (120, 168) 
\newsavebox{\foldera} 
\savebox{\foldera} 
(40,32) [b1]{% definition 
\multiput (0,0) (0,28) {2} 
{\line (1,0) {40}} 
\multiput (0,0) (40,0) {2} 
{\line (0,1) {28}} 
\put (1,28) {\oval (2,2) [t1]} 
\put (1,29) {\line(1,0) {5}} 
\put (9,29) {\oval (6,6) [t1]} 
\put (9,32) {\line (1,0) {8}} 
\put (17,29) {\oval (6,6) [tr] } 
\put (20, 29) {\line(1,0){19}} oe a. 
\put (39 , 28) {\oval (2,2) [tr] } 


























} 
\newsavebox{\folderb} 
\savebox{\folderb} 
(40,32) [1] {% definition 
\put (0,14) {\line(1,0) {8}} 
\put (8,0) {\usebox{\foldera}} 























} 

\put (34,26) {\line(0,1){102}} 

\put (14, 128) {\usebox{\foldera}} 

\multiput (34,86) (0,-37) {3} 
{\usebox{\folderb}} 

\end{picture} 














A picture box can be declared by the command 











\newsavebox{name} 





then defined by 





\savebox{name} (width,height) [position] {content} 











and finally arbitrarily often be drawn by 











\put (a, y) {\usebox{name}} 





The optional position parameter has the effect of defining the ‘anchor 
point’ of the savebox. In the example it is set to bl which puts the anchor 
point into the bottom left corner of the savebox. The other position specifiers 
are top and right. 
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The name argument refers to a FATRX storage bin and therefore is of 
a command nature (which accounts for the backslashes in the current ex- 
ample). Boxed pictures can be nested: In this example, \foldera is used 
within the definition of \folderb. 

The \oval command had to be used as the \line command does not 
work if the segment length is less than about 3mm. 


5.2.9 Quadratic Bézier Curves 


\setlength{\unitlength}{0.8cm} 
\begin{picture} (6,4) 
\linethickness{0.075mm} 
\multiput (0,0) (1,0){7} 
{\line(0,1){4}} 
\multiput (0,0) (0,1) {5} 
{\line(1,0){6}} 








\thicklines 

\put (0.5,0.5){\line(1,5){0.5}} 
\put (1,3) {\line(4, 1) {2}} 
\qbezier(0.5,0.5) (1,3) (3,3.5) 
\thinlines 

\put (2.5,2){\line(2,-1) {3}} 
\put (5.5,0.5) {\line(-1,5){0.5}} 
\linethickness{imm} 

\qbezier (2.5,2)(5.5,0.5) (5,3) 








a7 






































\thinlines 
\qbezier (4,2) (4,3) (3,3) 
\qbezier (3,3) (2,3) (2,2) 
\qbezier (2,2) (2,1) (3,1) 
\qbezier (3,1) (4,1) (4,2) 
\end{picture} 


As this example illustrates, splitting up a circle into 4 quadratic Bézier 
curves is not satisfactory. At least 8 are needed. The figure again shows the 
effect of the \linethickness command on horizontal or vertical lines, and of 
the \thinlines and the \thicklines commands on oblique line segments. 
It also shows that both kinds of commands affect quadratic Bézier curves, 
each command overriding all previous ones. 

Let Py = (21, yi), Po = (2, y2) denote the end points, and m4, m2 
the respective slopes, of a quadratic Bézier curve. The intermediate control 
point S = (x, y) is then given by the equations 

M2r2 —™m121 — (y2 — y1) 

rea = , 
mz— m4 (5.1) 

y= ytmi(x—a2) (=1, 2). 
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See Graphics in IATRX 2- [16] for a Java program which generates the nec- 
essary \qbezier command line. 


5.2.10 Catenary 


\setlength{\unitlength}{1cm} 
\begin{picture} (4.3,3.6) (-2.5,-0.25) 
\put (-2,0) {\vector (1,0) {4.4}} 
\put (2.45, -.05) {$x$} 
\put (0,0) {\vector(0,1){3.2}} 
\put (0,3.35) {\makebox (0,0) {$y$}} 
\qbezier(0.0,0.0) (1.2384,0.0) 
(2.0,2.7622) 
\qbezier(0.0,0.0)(-1.2384,0.0) 
(-2.0,2.7622) 
\lLinethickness{.075mm} 
\multiput (-2,0) (1,0) {5} 
{\line(0,1){3}} 
\multiput (-2,0) (0,1) {4} 


{\line(1,0){4}} 
\linethickness{. 2mm} 


\put( .3,.12763){\line(1,0){.4}} 
\put (.5,-.07237) {\line(0,1){.4}} ele 
\put (-.7,.12763){\line(1,0){.4}} ! x 


\put (-.5,-.07237){\line(0,1){.4}} | ®@ 
\put (.8, .54308) {\line(1,0){.4}} 
\put (1, .34308) {\line(0,1){.4}} 
\put (-1.2, .54308){\line(1,0){.4}} 
\put (-1, .34308) {\line(0,1){.4}} 
\put (1.3,1.35241){\line(1,0){.4}} 
\put (1.5,1.15241){\line(0,1){.4}} 
\put (-1.7,1.35241) {\line(1,0){.4}} 
\put (-1.5,1.15241){\line(0,1){.4}} 
\put (-2.5,-0.25) {\circle*{0.2}} 
\end{picture} 





and 









































In this figure, each symmetric half of the catenary y = coshaz — 1 is 
approximated by a quadratic Bézier curve. The right half of the curve ends 
in the point (2, 2.7622), the slope there having the value m = 3.6269. Using 
again equation (5.1), we can calculate the intermediate control points. They 
turn out to be (1.2384, 0) and (—1.2384, 0). The crosses indicate points of 
the real catenary. The error is barely noticeable, being less than one percent. 


This example points out the use of the optional argument of the 
\begin{picture} command. The picture is defined in convenient “mathe- 
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matical” coordinates, whereas by the command 








\begin{picture} (4.3,3.6)(-2.5,-0.25) 








its lower left corner (marked by the black disk) is assigned the coordinates 
(—2.5, —0.25). 


5.2.11 Rapidity in the Special Theory of Relativity 


\setlength{\unitlength}{0.8cm} 

\begin{picture} (6,4) (-3, -2) 
\put (-2.5,0){\vector (1,0) {5}} 
\put (2.7,-0.1){$\chi$} 





\put (0,-1.5) {\vector (0,1) {3}} 
\multiput (-2.5,1) (0.4,0) {13} , 8 =v/c=tanhyx 
{\line(1,0){0.2}} 
\multiput (-2.5,-1) (0.4,0) {13} 
{\line(1,0){0.2}} ~ Xx 
\put (0.2,1.4) 
{$\beta=v/c=\tanh\chi$} 
\qbezier (0,0) (0.8853,0.8853) 























(2,0.9640) e 
\qbezier (0,0) (-0.8853, -0.8853) 
(-2,-0.9640) 
\put (-3, -2) {\circle*{0.2}} 
\end{picture} 


The control points of the two Bézier curves were calculated with formu- 
las (5.1). The positive branch is determined by P; = (0, 0), mi = 1 and 
Py = (2, tanh2), mz = 1/cosh?2. Again, the picture is defined in mathe- 
matically convenient coordinates, and the lower left corner is assigned the 
mathematical coordinates (—3, —2) (black disk). 


5.3 The PGF and TikZ Graphics Packages 


Today every IATRX output generation system can create nice vector graphics, 
it’s just the interfaces that are rather diverse. The pgf package provides an 
abstraction layer over these interface. The pgf package comes with a large 
manual/tutorial of its own [17]. So we are only going to scratch the surface 
of the package with this little section. 

The pgf package comes with a high level access language provided by 
the tikz package. TikZ provides highly efficient commands to draw graphics 
right from inside your document. Use the tikzpicture environment to wrap 
your TikZ commands. 
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As mentioned above, there is an excellent manual for pgf and friends. 
So instead of actually explaining how it works, I will just show you a few 
examples so that you can get a first impression of how this tool works. 


First a simple nonsense diagram. 





\begin{tikzpicture} [scale=3] 
\clip (-0.1,-0.2) 
rectangle (1.8,1.2); 
\draw[step=.25cm,gray,very thin] lb 
(-1.4,-1.4) grid (3.4,3.4); 
\draw (-1.5,0) -- (2.5,0); 
\draw (0,-1.5) -- (0,1.5); - 
\draw (0,0) circle (1cm); \ 
\filldraw[fill=green!20!white, 
draw=green!50! black] 
(0,0) -- (3mm, Omm) 
arc (0:30:3mm) -- cycle; 
\end{tikzpicture} 


















































Note the semicolon (;) character. It separates the individual commands. 


A simple Venn diagram. 


\begin{tikzpicture} 
\node[circle,draw, 





minimum size=3cm, Aeninies psychology 
label=120: {economics}] 


at (0,0) {}; 
\node[circle,draw, 
minimum size=3cm, 
label=60: {psychology}] 
at (1,0) {}; 
\node (i) at (0.5,-1) {}; 
\node at (0.6,-2.5) 
{behavioral economics} 
edge[->, thick, behavioral economics 
out=60,in=-60] (i); 
\end{tikzpicture} 














Note the foreach loops in the next example. 
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\begin{tikzpicture} [scale=0.8] 
\tikzstyle{v}=[circle, minimum size=2mm,inner sep=0pt, draw] 
\foreach \i in {1,...,8} 





\foreach \j in {1,...,3} 
\node [v] 
(G-\i-\j) at (\i,\3) 13; 
\foreach \i in {1,...,8} 
\foreach \j/\o in {1/2,2/3} 
\draw [->] 


(G-\i-\j) -- (G-\i-\o); 
\foreach \i/\n in 
{1/2,2/3,3/4,4/5,5/6,6/7, 7/8} 
\foreach \j/\o in {1/2,2/3} { 
\draw[->] (G-\i-\j) -- (G-\n-\o); 
\draw[->] (G-\n-\j) -- (G-\i-\o); 
} 
\end{tikzpicture} 














With the \usetikzlibrary command in the preamble you can enable a 
wide variety of additional features for drawing special shapes, like this box 
which is slightly bent. 


\usetikzlibrary{% 
decorations. pathmorphing} 
\begin{tikzpicture}[ 
decoration={bent, aspect=.3}] 
\draw [decorate,fill=lightgray] 

(0,0) rectangle (5.5,4); 
\node [circle, draw] 

(A) at (.5,.5) {A}; 
\node [circle, draw] 

(B) at (5,3.5) {B}; 
\draw[->,decorate] (A) -- (B); 
\draw[->,decorate] (B) -- (A); 

\end{tikzpicture} 
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\usetikzlibrary{positioning} 
\begin{tikzpicture}[xscale=6, 
yscale=8 , >=stealth] 
\tikzstyle{v}=[circle, 
minimum size=1mm,draw,thick] 





\node[v] (a) {$1$}; 

\nodel[v] (b) [right=of a] {$2$}; C1.) (2) 
\node[v] (c) [below=of a] {$2$}; 
\node[v] (d) [below=of b] {$1$}; 


\draw([thick, ->] 
(a) to node {} (c); (2) (1) 


\draw (thick, ->] 
(a) to node {} (d); 

\draw[thick, ->] 
(b) to node {} (d); 

\end{tikzpicture} 














You can even draw syntax diagrams that look as if they came straight 
from a book on Pascal programming. The code is a bit more daunting than 
the example above, so I will just show you the result. If you have a look 
at the pgf documentation you will find a detailed tutorial on drawing this 
exact diagram. 


— >) unsigned integer ore y unsigned integer 


And there is more, if you have to draw plots of numerical data or func- 
tions, you should have a closer look at the pgfplot package. It provides 
everything you need to draw plots. It can even call the external gnuplot 
command to evaluate actual functions you wrote into the graph. 

For more inspiration make sure to visit Kjell Magne Fauske’s excellent 
http://www.texample.net/tikz/. it contains an ever expanding store of 
beautiful graphs and other !TexX code. On TReXample.net you will also find 
a list of tools to work with PGF /TikZ so that you do not have to write all 
that code by hand. 





Chapter 6 


Customising IATRX 


Documents produced with the commands you have learned up to this point will 
look acceptable to a large audience. While they are not fancy-looking, they 
obey all the established rules of good typesetting, which will make them easy 
to read and pleasant to look at. 

However, there are situations where ATEX does not provide a command or 
environment that matches your needs, or the output produced by some existing 
command may not meet your requirements. 

In this chapter, | will try to give some hints on how to teach ATEX new tricks 
and how to make it produce output that looks different from what is provided 
by default. 


6.1 New Commands, Environments and 
Packages 


You may have noticed that all the commands I introduce in this book are 
typeset in a box, and that they show up in the index at the end of the book. 
Instead of directly using the necessary XT fX commands to achieve this, I 
have created a package in which I defined new commands and environments 
for this purpose. Now I can simply write: 








\begin{1lscommand} 
\ci{dum} 
\end{lscommand} 


\dum 

















In this example, I am using both a new environment called 
1scommand, which is responsible for drawing the box around the command, 
and a new command named \ci, which typesets the command name and 
makes a corresponding entry in the index. Check this out by looking up the 
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\dum command in the index at the back of this book, where you'll find an 
entry for \dum, pointing to every page where I mentioned the \dum command. 

If I ever decide that I do not like having the commands typeset in a box 
any more, I can simply change the definition of the 1scommand environment 
to create a new look. This is much easier than going through the whole 
document to hunt down all the places where I have used some generic JATRX 
commands to draw a box around some word. 


6.1.1 New Commands 


To add your own commands, use the 





\newcommand{name} [num] {definition} 











command. Basically, the command requires two arguments: the name of 
the command you want to create, and the definition of the command. The 
num argument in square brackets is optional and specifies the number of 
arguments the new command takes (up to 9 are possible). If missing it 
defaults to 0, i.e. no argument allowed. 

The following two examples should help you to get the idea. The first 
example defines a new command called \tnss. This is short for “The Not 
So Short Introduction to ATRX 2-.” Such a command could come in handy 
if you had to write the title of this book over and over again. 


\newcommand{\tnss}{The not 
so Short Introduction to 
\LaTeXe} 

This is ~~\tnss'' \ldots{} 

~*\tnss'! 


The next example illustrates how to define a new command that takes 
two arguments. The #1 tag gets replaced by the first argument you specify, 








This is “The not so Short Introduction to 
IATRX 2-” ... “The not so Short Introduc- 
tion to ATRX 2.” 





#2 with the second argument, and so on. 


\newcommand{\txsit} [2] 

{This is the \emph{#1} 

#2 Introduction to \LaTeXe} 
% in the document body: 
\beginfitemize} 
\item \txsit{not so}{short} 
\item \txsit{very}{long} 
\end{itemize} 








e This is the not so short Introduction 
to LT RX 2- 
e This is the very long Introduction 


to TEX 2¢ 








LTRX will not allow you to create a new command that would overwrite 
an existing one. But there is a special command in case you explicitly 
want this: \renewcommand. It uses the same syntax as the \newcommand 
command. 
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In certain cases you might also want to use the \providecommand com- 
mand. It works like \newcommand, but if the command is already defined, 
IATRX 2¢ will silently ignore it. 

There are some points to note about whitespace following ATRX com- 
mands. See page 5 for more information. 

6.1.2 New Environments 
Just as with the \newcommand command, there is a command to create 
your own environments. The \newenvironment command uses the following 
syntax: 

\newenvironment {name} [num] {before} {after} 

Again \newenvironment can have an optional argument. The material 
specified in the before argument is processed before the text in the envi- 
ronment gets processed. The material in the after argument gets processed 
when the \end{name} command is encountered. 

The example below illustrates the usage of the \newenvironment com- 
mand. 

\newenvironment {king} 
{\rule{tex}{tex}% 
\hspace{\stretch{1}}} 
{\hspace{\stretch{1}}% 
\rule{tex}{1lex}} 1. My humble subjects ... . 
\beginfking} 
My humble subjects \ldots 
\end{king} 


The num argument is used the same way as in the \newcommand com- 
mand. IATfX makes sure that you do not define an environment that al- 
ready exists. If you ever want to change an existing command, use the 


\renewenvironment command. It uses the same syntax as the \newenvironment 


command. 

The commands used in this example will be explained later. For the 
\rule command see page 119, for \stretch go to page 113, and more in- 
formation on \hspace can be found on page 113. 


6.1.3. Extra Space 


When creating a new environment you may easily get bitten by extra spaces 
creeping in, which can potentially have fatal effects, for example when you 
want to create a title environment which supresses its own indentation as well 
as the one on the following paragraph. The \ignorespaces command in the 
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begin block of the environment will make it ignore any space after executing 
the begin block. The end block is a bit more tricky as special processing 
occurs at the end of an environment. With the \ignorespacesafterend 
IATRX will issue an \ignorespaces after the special ‘end’ processing has 
occurred. 


\newenvironment{simple}% 




















{\noindent}% 
{\par\noindent} See the space 
to the left. 
\begin{simple} Sains 
See the space\\to the left. here: 
\end{simple} 
Same\\here. 
\newenvironment{correct}% 
{\noindent\ignorespaces}% 
{\par\noindent% Noeeaes 
\ignorespacesafterend} £6. ihe eke. 
\begin{correct} Same 
No space\\to the left. here. 
\end{correct} 
Same\\here. 


6.1.4 Command-line ETRX 


If you work on a Unix-like OS, you might be using Makefiles to build your 
TeX projects. In that connection it might be interesting to produce dif- 
ferent versions of the same document by calling “TeX with command-line 
parameters. If you add the following structure to your document: 


\usepackage{ifthen} 
\ifthenelse{\equal{\blackandwhite}{true}}{ 
% "black and white" mode; do something.. 
Jt 
% "color" mode; do something different.. 


} 


Now call AT RX like this: 
latex '\newcommand{\blackandwhite}{true}\input{test.tex}' 


First the command \blackandwhite gets defined and then the actual 
file is read with input. By setting \blackandwhite to false the color version 
of the document would be produced. 


6.2 Fonts and Sizes 
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6.1.5 Your Own Package 


If you define a lot of new environments and commands, the preamble of 
your document will get quite long. In this situation, it is a good idea to 
create a JATRX package containing all your command and environment def- 
initions. Use the \usepackage command to make the package available in 
your document. 





% Demo Package by Tobias Oetiker 
\ProvidesPackage{demopack} 
\newcommand{\tnss}{The not so Short Introduction 
to \LaTeXe} 
\newcommand{\txsit}[1]{The \emph{#1} Short 
Introduction to \LaTeXe} 
\newenvironment{king}{\begin{quote}}{\end{quote}} 





Figure 6.1: Example Package. 


Writing a package basically consists of copying the contents of your doc- 
ument preamble into a separate file with a name ending in .sty. There is 
one special command, 











\ProvidesPackage{package name} 





for use at the very beginning of your package file. \ProvidesPackage tells 
Ia4TeX the name of the package and will allow it to issue a sensible error 
message when you try to include a package twice. Figure 6.1 shows a small 
example package that contains the commands defined in the examples above. 


6.2 Fonts and Sizes 


6.2.1 Font Changing Commands 


I4TpeX chooses the appropriate font and font size based on the logical struc- 
ture of the document (sections, footnotes, ...). In some cases, one might like 
to change fonts and sizes by hand. To do this, use the commands listed in 
Tables 6.1 and 6.2. The actual size of each font is a design issue and depends 
on the document class and its options. Table 6.3 shows the absolute point 
size for these commands as implemented in the standard document classes. 





{\small The small and 


\textbf{bold} Romans ruled} The small and bold Romans ruled all of 


{\Large all of great big great big Italy. 
\textit{Italy}.} 
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One important feature of ATRX 2¢ is that the font attributes are inde- 
pendent. This means that issuing size or even font changing commands, and 


still keep bold or slant attributes set earlier. 


In math mode use the font changing commands to temporarily exit math 
mode and enter some normal text. If you want to switch to another font 
for math typesetting you need another special set of commands; refer to 


Table 6.4. 


In connection with the font size commands, curly braces play a significant 
role. They are used to build groups. Groups limit the scope of most ATRxX 


commands. 


He likes {\LARGE large and 
{\small small} letters}. 


The font size commands also change the line spacing, but only if the 
paragraph ends within the scope of the font size command. The closing 
curly brace } should therefore not come too early. Note the position of the 








He likes large and smai let- 


ters. 





Table 6.1: Fonts. 











\textrm{...} roman \textsf{...} sans serif 

\texttt{...} typewriter 

\textmd{...} medium \textbf{...} bold face 

\textup{...} upright \textit{...} italic 

\textsl{...} slanted \textsc{...} SMALL CAPS 
\emph{...} emphasized \textnormal{...} document font 

Table 6.2: Font Sizes. 

\t iny tiny font \Large larger font 

Secu ipueize very small font \LARCE very large font 

\footnotesize quite small font 

\small small font \huge hu ge 

\normalsize normal font 

\large large font \Huge largest 





6.2 Fonts and Sizes 
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Table 6.3: Absolute Point Sizes in Standard Classes. 





size 


\tiny 


\scriptsize 
\footnotesize 


\small 


\normalsize 


\large 
\Large 
\LARGE 
\huge 
\Huge 


opt 6pt 
Tpt 8pt 
8pt Opt 
9pt 10pt 
10pt 1lpt 
12pt 12pt 
14pt 14pt 
17pt 17pt 
20pt 20pt 
25pt 25pt 


10pt (default) 11lpt option 12pt option 


6pt 

8pt 
10pt 
11pt 
12pt 
14pt 
17pt 
20pt 
25pt 
25pt 





Table 6.4: Math Fonts. 





\mathrm{... 
\mathbf{... 
\mathsf{... 
\mathtt{... 
\mathit{... 
\mathcal{...} 


www yw 


Roman Font 

Boldface Font 

Sans Serif Font 
Typewriter Font 

Italic Font 
CALLIGRAPHIC FONT 


\mathnormal{...} Normal Font 
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eee nee Don’t read this! It is not 
It is not true. io 

You can believe me!\par} true. You can believe me! 
{\Large This is not true either. This is not true either. But 
But remember I am a liar.}\par remember I am a liar. 


\begin{Large} 


\par command in the next two examples. ! 























If you want to activate a size changing command for a whole paragraph 
of text or even more, you might want to use the environment syntax for font 
changing commands. 





ie tite eee _ 
ale: IS MOG eae This is not true. But then 


But then again, what is these 
days \ldots 
\end{Large} 


\newcommand{\oops} [1] {% 

\textbf{#1}} Do not enter this room, it’s occupied by 
Do not \oopsf{enter} this room, machines of unknown origin and pur- 
it's occupied by \oops{machines} pose. 


of unknown origin and purpose. 


again, what is these days ... 








This will save you from counting lots of curly braces. 


6.2.2 Danger, Will Robinson, Danger 


As noted at the beginning of this chapter, it is dangerous to clutter your 
document with explicit commands like this, because they work in opposition 
to the basic idea of TeX, which is to separate the logical and visual markup 
of your document. This means that if you use the same font changing 
command in several places in order to typeset a special kind of information, 
you should use \newcommand to define a “logical wrapper command” for the 
font changing command. 














This approach has the advantage that you can decide at some later 
stage that you want to use a visual representation of danger other than 
\textbf, without having to wade through your document, identifying all 
the occurrences of \textbf and then figuring out for each one whether it 
was used for pointing out danger or for some other reason. 





'\par is equivalent to a blank line 
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Please note the difference between telling ATRX to emphasize something 
and telling it to use a different font. The \emph command is context aware, 
while the font commands are absolute. 


\textit{You can also 





\emph{emphasize} text if 
it is set in italics,} You can also emphasize tert if it is 
\textsf{in a set in italics, in a sans-serif font, or in 
\emph{sans-serif} font,} typewriter style. 
\texttt{or in 








\emph{typewriter} style.} 


6.2.3 Advice 


To conclude this journey into the land of fonts and font sizes, here is a little 
word of advice: 


ensue The uO RE fonts you use in a document, the 
more READABLE and beautiful it becomeS. 


6.3. Spacing 


6.3.1 Line Spacing 


If you want to use larger inter-line spacing in a document, change its value 
by putting the 











\linespread{factor} 





command into the preamble of your document. Use \linespread{1.3} 
for “one and a half” line spacing, and \linespread{1.6} for “double” line 
spacing. Normally the lines are not spread, so the default line spread factor 
is l. 

Note that the effect of the \linespread command is rather drastic and 
not appropriate for published work. So if you have a good reason for chang- 
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ing the line spacing you might want to use the command: 








\setlength{\baselineskip}{1.5\baselineskip} 








{\setlength{\baselineskip}% 


This paragraph is typeset with 
the baseline skip set to 1.5 of line skip set to 1.5 of what it was before. 
what it was before. Note the par 
command at the end of the 

paragraph. \par} paragraph. 


This paragraph has a clear 
purpose, it shows that after the 
curly brace has been closed, 





1.5\b li ki 
ras Unubasueges a) This paragraph is typeset with the base- 


Note the par command at the end of the 


This paragraph has a clear purpose, it 
shows that after the curly brace has been 
closed, everything is back to normal. 











everything is back to normal. 


6.3.2 Paragraph Formatting 


In ATX, there are two parameters influencing paragraph layout. By placing 
a definition like 


\setlength{\parindent}{Opt} 
\setlength{\parskip}{lex plus 0.5ex minus 0.2ex} 


in the preamble of the input file, you can change the layout of paragraphs. 
These two commands increase the space between two paragraphs while set- 
ting the paragraph indent to zero. 

The plus and minus parts of the length above tell TpX that it can 
compress and expand the inter-paragraph skip by the amount specified, if 
this is necessary to properly fit the paragraphs onto the page. 

In continental Europe, paragraphs are often separated by some space and 
not indented. But beware, this also has its effect on the table of contents. 
Its lines get spaced more loosely now as well. To avoid this, you might 
want to move the two commands from the preamble into your document to 
some place below the command \tableofcontents or to not use them at 
all, because you'll find that most professional books use indenting and not 
spacing to separate paragraphs. 

If you want to indent a paragraph that is not indented, use 





\indent 











at the beginning of the paragraph.” Obviously, this will only have an effect 





To indent the first paragraph after each section head, use the indentfirst package in the 
‘tools’ bundle. 
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when \parindent is not set to zero. 
To create a non-indented paragraph, use 











\noindent 





as the first command of the paragraph. This might come in handy when 
you start a document with body text and not with a sectioning command. 


6.3.3. Horizontal Space 


IATRX determines the spaces between words and sentences automatically. To 
add horizontal space, use: 








\hspace{length} 








If such a space should be kept even if it falls at the end or the start of 
a line, use \hspace* instead of \hnspace. The length in the simplest case is 
just a number plus a unit. The most important units are listed in Table 6.5. 





This\hspace{1.5cm}is a space This 


is a space of 1.5 cm. 
of 1.5 cm. 











The command 











\stretch{n} 





generates a special rubber space. It stretches until all the remaining space 
on a line is filled up. If multiple \nspace{\stretch{n}} commands are 
issued on the same line, they occupy all available space in proportion of 
their respective stretch factors. 





x\hspace{\stretch{1}} 
x\hspace{\stretch{3}}x 








When using horizontal space together with text, it may make sense to 
make the space adjust its size relative to the size of the current font. This 
can be done by using the text-relative units em and ex: 





{\Large{}big\hspace{lem}y}\\ big y 
{\tiny{}tin\hspace{1lem}y} tiny 
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Table 6.5: TX Units. 





mm millimetre + 1/25 inch  U 
cm centimetre= 10mm lL J 
in inch= 254mm | 
pt point + 1/72 inch = 5 mm | 

em approx width of an ‘M’ in the current font ‘J 


ex approx height of an ‘x’ in the current font L 








6.3.4 Vertical Space 


The space between paragraphs, sections, subsections, ... is determined au- 
tomatically by ATpxX. If necessary, additional vertical space between two 
paragraphs can be added with the command: 











\vspacet{length} 





This command should normally be used between two empty lines. If the 
space should be preserved at the top or at the bottom of a page, use the 
starred version of the command, \vspace*, instead of \vspace. 

The \stretch command, in connection with \pagebreak, can be used 
to typeset text on the last line of a page, or to centre text vertically on a 


page. 


Some text \ldots 


\vspace{\stretch{1}} 
This goes onto the last line of the page. \pagebreak 


Additional space between two lines of the same paragraph or within a 
table is specified with the 








\\ [length] 








command. 
With \bigskip and \smallskip you can skip a predefined amount of 
vertical space without having to worry about exact numbers. 


6.4 Page Layout 


TATREX 2¢ allows you to specify the paper size in the \documentclass com- 
mand. It then automatically picks the right text margins, but sometimes 


6.4 Page Layout 
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Mbrein 
otes 





1 one inch + \hoffset 
\oddsidemargin = 22pt 
or \evensidemargin 

5 \headheight = 12pt 

7 \textheight = 595pt 

9 \marginparsep = 7pt 

11 \footskip = 27pt 
\hoffset = Opt 
\paperwidth = 597pt 





10 





one inch + \voffset 
\topmargin = 22pt 


\headsep = 19pt 

\textwidth = 360pt 
\marginparwidth = 106pt 
\marginparpush = 5pt (not shown) 
\voffset = Opt 

\paperheight = 845pt 


Figure 6.2: Layout parameters for this book. Try the layouts package to 
print the layout of your own document. 


116 


Customising ATpxX 





you may not be happy with the predefined values. Naturally, you can change 
them. Figure 6.2 shows all the parameters that can be changed. The figure 
was produced with the layout package from the tools bundle.® 

WAIT! ...before you launch into a “Let’s make that narrow page a bit 
wider” frenzy, take a few seconds to think. As with most things in JATRxX, 
there is a good reason for the page layout to be as it is. 

Sure, compared to your off-the-shelf MS Word page, it looks awfully 
narrow. But take a look at your favourite book’ and count the number of 
characters on a standard text line. You will find that there are no more than 
about 66 characters on each line. Now do the same on your ATRX page. You 
will find that there are also about 66 characters per line. Experience shows 
that the reading gets difficult as soon as there are more characters on a 
single line. This is because it is difficult for the eyes to move from the end 
of one line to the start of the next one. This is also why newspapers are 
typeset in multiple columns. 

So if you increase the width of your body text, keep in mind that you 
are making life difficult for the readers of your paper. But enough of the 
cautioning, I promised to tell you how you do it ... 

l4TeX provides two commands to change these parameters. They are 
usually used in the document preamble. 

The first command assigns a fixed value to any of the parameters: 











\setlength{parameter} {length} 





The second command adds a length to any of the parameters: 











\addtolength{ parameter} {length} 





This second command is actually more useful than the \setlength com- 
mand, because it works relative to the existing settings. To add one cen- 
timetre to the overall text width, I put the following commands into the 
document preamble: 


\addtolength{\hoffset}{-0.5cm} 
\addtolength{\textwidth}{1cm} 


In this context, you might want to look at the calc package. It allows 
you to use arithmetic operations in the argument of \setlength and other 
places where numeric values are entered into function arguments. 





3pkg/tools 
“T mean a real printed book produced by a reputable publisher. 


6.5 More Fun With Lengths 
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6.5 More Fun With Lengths 


Whenever possible, I avoid using absolute lengths in ATfX documents. I 
rather try to base things on the width or height of other page elements. For 
the width of a figure this could be \textwidth in order to make it fill the 
page. 

The following 3 commands allow you to determine the width, height and 
depth of a text string. 





\settoheight{variable}{text} 
\settodepth{variable} {text} 
\settowidth{variable} {text} 











The example below shows a possible application of these commands. 


\flushleft 

\newenvironment {vardesc}[1]{% 
\settowidth{\parindent}{#1:\ } 
\makebox [Opt] [r] {#1:\ }}{} 





\begin{displaymath} e2+eRae 
a72+b*2=c72 
\end{displaymath} Where: a, b — are adjacent to the right 


angle of a right-angled triangle. 
\begin{vardesc}{Where}$a$, 


$b$ -- are adjacent to the right 
angle of a right-angled triangle. 


c — is the hypotenuse of the 
triangle and feels lonely. 


$c$ -- is the hypotenuse of at all. Isn’t that puzzling? 





d — finally does not show up here 








the triangle and feels lonely. 


$d$ -- finally does not show up 
here at all. Isn't that puzzling? 
\end{vardesc} 


6.6 Boxes 


I4TeX builds up its pages by pushing around boxes. At first, each letter is 
a little box, which is then glued to other letters to form words. These are 
again glued to other words, but with special glue, which is elastic so that a 
series of words can be squeezed or stretched as to exactly fill a line on the 
page. 

IT admit, this is a very simplistic version of what really happens, but the 
point is that TEX operates on glue and boxes. Letters are not the only things 
that can be boxes. You can put virtually everything into a box, including 
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other boxes. Each box will then be handled by IATpX as if it were a single 
letter. 

In earlier chapters you encountered some boxes, although I did not tell 
you. The tabular environment and the \includegraphics, for example, 
both produce a box. This means that you can easily arrange two tables or 
images side by side. You just have to make sure that their combined width 
is not larger than the textwidth. 

You can also pack a paragraph of your choice into a box with either the 








\parbox [pos] { width} {text} 








command or the 











\begin{minipage} [pos] {width} text \end{minipage} 





environment. The pos parameter can take one of the letters c, t or b to 
control the vertical alignment of the box, relative to the baseline of the 
surrounding text. width takes a length argument specifying the width of 
the box. The main difference between a minipage and a \parbox is that you 
cannot use all commands and environments inside a parbox, while almost 
anything is possible in a minipage. 

While \parbox packs up a whole paragraph doing line breaking and 
everything, there is also a class of boxing commands that operates only on 
horizontally aligned material. We already know one of them; it’s called 
\mbox. It simply packs up a series of boxes into another one, and can be 
used to prevent IATeX from breaking two words. As boxes can be put inside 
boxes, these horizontal box packers give you ultimate flexibility. 








\makebox [width] [pos] {text} 








width defines the width of the resulting box as seen from the outside.° Be- 
sides the length expressions, you can also use \width, \height, \depth, and 
\totalheight in the width parameter. They are set from values obtained 
by measuring the typeset tert. The pos parameter takes a one letter value: 
center, flushleft, flushright, or spread the text to fill the box. 

The command \framebox works exactly the same as \makebox, but it 
draws a box around the text. 

The following example shows you some things you could do with the 
\makebox and \framebox commands. 





°This means it can be smaller than the material inside the box. You can even set the width 
to Opt so that the text inside the box will be typeset without influencing the surrounding 
boxes. 
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\makebox [\textwidth] {% 
c entra 1}\par 
\makebox [\textwidth] [s]{% central 
s prea d}\par s p r e a d 
\framebox[1.1\width]{Guess I'm 
framed now!} \par 
\framebox[0.8\width] [r]{Bummer, p,] 
I am too wide} \par 
\framebox [1cm] [1] {never never |1@anl yeu anad this? 
mind, so am I} 
Can you read this? 











Guess I’m framed now! 











mer, I am too wide 





























Now that we control the horizontal, the obvious next step is to go for 
the vertical.° No problem for ATRX. The 











\raisebox {lift} Lextend-above-baseline] Lextend-below-baseline] {text} 





command lets you define the vertical properties of a box. You can use 
\width, \height, \depth, and \totalheight in the first three parameters, 
in order to act upon the size of the box inside the text argument. 


\raisebox{0Opt} [Opt] [Opt] {\Large% 
\textbf{Aaaa\raisebox{-0.3ex}{a}% 
\raisebox{-0.7ex}{aa}% 





\raisebox{-1.2ex}{r}% Aaaaaga she shouted, but not 
\raisebox{-2.2ex}{gh% even the next @me in line noticed that 
\raisebox{-4.5ex}{h}}} something terribig pad happened to her. 
she shouted, but not even the next 








one in line noticed that something 
terrible had happened to her. 


6.7 Rules 


A few pages back you may have noticed the command 








\rule [lift] {width} {height} 








In normal use it produces a simple black box. 


\rule{3mm}{.1pt}% 


\rule [-1mm] {5mm}{1cm}%, 

\rule{3mm}{.1pt}% 7 | 
\rule [1mm] {1cm}{5mm}¥, — 
\rule{3mm}{.1pt} 














®°Total control is only to be obtained by controlling both the horizontal and the vertical 
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This is useful for drawing vertical and horizontal lines. The line on the title 
page, for example, has been created with a \rule command. 


The End. 


Appendix A 


Installing IATRX 


Knuth published the source to TEX back in a time when nobody knew about 
Open Source and/or Free Software. The License that comes with TEX lets you 
do whatever you want with the source, but you can only call the result of your 
work TEX if the program passes a set of tests Knuth has also provided. This has 
lead to a situation where we have free TEX implementations for almost every 
Operating System under the sun. This chapter will give some hints on what to 
install on Linux, macOS and Windows, to get a working TEX setup. 


A.1 What to Install 


To use ATRX on any computer system, you need several programs. 


1. The TeX /I4TRX program for processing your IXTfX source files into 
typeset PDF or DVI documents. 


2. A text editor for editing your IATRX source files. Some products even 
let you start the ATRX program from within the editor. 


3. A PDF/DVI viewer program for previewing and printing your docu- 
ments. 


4. A program to handle PosTScRIPT files and images for inclusion into 
your documents. 


For every platforms there are several programs that fit the requirements 
above. Here we just tell about the ones we know, like and have some expe- 
rience with. 


A.2 Cross Platform Editor 


While TEX is available on many different computing platforms, IXTFX editors 
have long been highly platform specific. 
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Over the past few years I have come to like Texmaker quite a lot. Apart 
from being very a useful editor with integrated pdf-preview and syntax high- 
lighting, it has the advantage of running on Windows, Mac and Unix/Linux 
equally well. See http://www.xmimath.net/texmaker for further infor- 
mation. There is also a forked version of Texmaker called TeXstudio on 
http://texstudio.sourceforge.net/. It also seems well maintained and 
is also available for all three major platforms. 

You will find some platform specific editor suggestions in the OS sections 
below. 


A.3 TREX on macOS 


A.3.1  TRX Distribution 


Just download MacTeX. It is a pre-compiled !ATRX distribution for macOS. 
MacTeX provides a full ATX installation plus a number of additional tools. 
Get MacTex from http://www.tug.org/mactex/. 


A.3.2. macOS TpX Editor 


If you are not happy with our cross-platform suggestion Texmaker (section 
A.2). 

The most popular open source editor for ATX on the mac seems to be 
TEXshop. Get a copy from http: //www.uoregon.edu/~koch/texshop. It 
is also contained in the MacTeX distribution. 

Recent TeXLive distributions contain the TeXworks editor http: //texworks. 
org/ which is a multi-platform editor based on the TRXShop design. Since 
TrXworks uses the Qt toolkit, it is available on any platform supported by 
this toolkit (macOS, Windows, Linux). 


A.3.3 Treat yourself to PDF View 


Use PDF View for viewing PDF files generated by ATRX, it integrates tightly 

with your IATRX text editor. PDF View is an open-source application, avail- 

able from the PDF View website on 

http://pdfview.sourceforge.net/. After installing, open PDF Views pref- 
erences dialog and make sure that the automatically reload documents option 

is enabled and that PDFSync support is set appropriately. 


A.4 TRrX on Windows 


A.4.1 Getting TREX 


First, get a copy of the excellent Mik TEX distribution from 
http://www.miktex.org/. It contains all the basic programs and files re- 
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quired to compile ATX documents. The coolest feature in my eyes, is that 
MikTpx will download missing !TRX packages on the fly and install them 
magically while compiling a document. Alternatively you can also use the 
TeXlive distribution which exists for Windows, Unix and Mac OS to get 
your base setup going http://www.tug.org/texlive/. 


A.4.2 A FATRX editor 


If you are not happy with our cross-platform suggestion Texmaker (section 
A.2). 

TeXnicCenter uses many concepts from the programming-world to pro- 
vide a nice and efficient ATRX writing environment in Windows. Get your 
copy from 
http: //www.texniccenter.org/. TeXnicCenter integrates nicely with Mik- 
TeX. 

Recent TeXLive distributions contain the TRXworks Editor http:// 
texworks.org/. It supports Unicode and requires at least Windows XP. 


A.4.3. Document Preview 


You will most likely be using Yap for DVI preview as it gets installed with 
MikTeX. For PDF you may want to look at Sumatra PDF http://blog. 
kowalczyk.info/software/sumatrapdf/. I mention Sumatra PDF be- 
cause it lets you jump from any position in the pdf document back into 
corresponding position in your source document. 


A.4.4 Working with graphics 


Working with high quality graphics in AT@X means that you have to use 
Encapsulated PosTSCRIPT (eps) or PDF as your picture format. The pro- 
gram that helps you deal with this is called GhostScript. You can get it, 
together with its own front-end GhostView, from http://www.cs.wisc. 
edu/~ghost/. 

If you deal with bitmap graphics (photos and scanned material), you 
may want to have a look at the open source Photoshop alternative Gimp, 
available from http://gimp-win.sourceforge.net/. 


A.5 TrX on Linux 


If you work with Linux, chances are high that JAT@X is already installed 
on your system, or at least available on the installation source you used to 
setup. Use your package manager to install the following packages: 


e texlive — the base TeX /MTpX setup. 
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e emacs (with AUCTeX) — an editor that integrates tightly with ATRxX 
through the add-on AUCTeX package. 


e ghostscript — a POSTSCRIPT preview program. 

e xpdf and acrobat — a PDF preview program. 

e imagemagick — a free program for converting bitmap images. 
e gimp — a free Photoshop look-a-like. 


e inkscape — a free illustrator/corel draw look-a-like. 


If you are looking for a more windows like graphical editing environment, 
check out Texmaker. See section A.2. 

Most Linux distros insist on splitting up their TRX environments into a 
large number of optional packages, so if something is missing after your first 
install, go check again. 
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